ref-manual: Re-write of the EXTRA_IMAGE_FEATURES variable.

Modeled this after the re-write of the IMAGE_FEATURES
variable.

(From yocto-docs rev: 14f9e9926ad8abc0e2936ac59c90514406675bd3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2013-04-02 14:57:26 -07:00 committed by Richard Purdie
parent 46c17c9c47
commit c0d6c1731d
1 changed files with 30 additions and 11 deletions

View File

@ -946,14 +946,22 @@ Core layer for images cannot be removed
<glossentry id='var-EXTRA_IMAGE_FEATURES'><glossterm>EXTRA_IMAGE_FEATURES</glossterm>
<glossdef>
<para>Allows you to add extra packages to the generated images.
You set this variable in the <filename>local.conf</filename>
configuration file.
Note that some image features are also added using the
<filename><link linkend='var-IMAGE_FEATURES'>IMAGE_FEATURES</link></filename>
variable generally configured in image recipes.
You can use this variable to add more features in addition to those.
Here are some examples of features you can add:</para>
<para>
The list of additional features to include in an image.
Typically, you configure this variable in an image recipe.
You can also configure it in the <filename>local.conf</filename>
file found in the
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
<note>
Use the
<link linkend='var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></link>
variable to define the primary list of features you want to
add to the image.
</note>
</para>
<para>
Here are some examples of features you can add:
<literallayout class='monospaced'>
"dbg-pkgs" - Adds -dbg packages for all installed packages
including symbol information for debugging and
@ -981,10 +989,21 @@ Core layer for images cannot be removed
password. You should remove this feature
before you produce a production image.
</literallayout>
</para>
<para>There are other valid features too, see the
<link linkend='ref-features-image'>Images</link>
section for more details.</para>
<para>
For a complete list of image features that ships with the
Yocto Project, see the
"<link linkend="ref-features-image">Images</link>"
section.
</para>
<para>
For some examples that show how to customize your image by
using this variable, see the
"<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-customimage-imagefeatures'>Customizing Images Using Custom <filename>IMAGE_FEATURES</filename> and <filename>EXTRA_IMAGE_FEATURES</filename></ulink>"
section in the Yocto Project Development Manual.
</para>
</glossdef>
</glossentry>