diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 9096ea61a4..b28b7e21ec 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -606,38 +606,48 @@ EXTRA_IMAGE_FEATURES - Ultimately users might want to add extra image features to the set by using the + Ultimately, you might want to add extra image features to the + set by using the IMAGE_FEATURES variable. To create these features, the best reference is - meta/classes/core-image.bbclass, which shows how this is - achieved. + meta/classes/core-image.bbclass, which + shows how you can add features. In summary, the file looks at the contents of the - IMAGE_FEATURES - variable and then maps that into a set of tasks or packages. - Based on this information, the + IMAGE_FEATURES variable and then maps those + contents into a set of tasks or packages. + Based on this information, the build system automatically + generates the IMAGE_INSTALL - variable is generated automatically. - Users can add extra features by extending the class or creating a custom class for use - with specialized image .bb files. + variable. + You can add extra features by extending the class or creating a + custom class for use with specialized image + .bb files. You can also add more features by configuring the EXTRA_IMAGE_FEATURES - variable in the local.conf file found in the Source Directory - located in the Build Directory. + variable in the local.conf file found in + the local.conf file, which is located in + the Build Directory. - The Yocto Project ships with two SSH servers you can use in your images: - Dropbear and OpenSSH. - Dropbear is a minimal SSH server appropriate for resource-constrained environments, - while OpenSSH is a well-known standard SSH server implementation. - By default, the core-image-sato image is configured to use Dropbear. - The core-image-basic and core-image-lsb - images both include OpenSSH. - The core-image-minimal image does not contain an SSH server. - To change these defaults, edit the IMAGE_FEATURES variable + The Yocto Project ships with two SSH servers you can use in your + images: Dropbear and OpenSSH. + Dropbear is a minimal SSH server appropriate for + resource-constrained environments, while OpenSSH is a well-known + standard SSH server implementation. + By default, the core-image-sato image is + configured to use Dropbear. + The core-image-basic and + core-image-lsb images both + include OpenSSH. + The core-image-minimal image does not + contain an SSH server. + To change these defaults, edit the + IMAGE_FEATURES variable so that it sets the image you are working with to include - ssh-server-dropbear or ssh-server-openssh. + ssh-server-dropbear or + ssh-server-openssh.