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