ref-manual: Applied review edits for new classes and variables.

These edits were minor with the addition of some descriptions that
had to be fleshed out.  All comments from Paul Eggleton.

(From yocto-docs rev: 4ae7c5a5e5aa23307e28de0832d379145c4ef8f1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 69 insertions, 30 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index cc5382f334..09d01cb478 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -242,7 +242,19 @@
          <glossentry id='var-ASSUME_PROVIDED'><glossterm>ASSUME_PROVIDED</glossterm>
             <glossdef>
                 <para>
-                    I need a description here.
+                    Lists recipe names
+                    (<link linkend='var-PN'><filename>PN</filename></link>
+                    values) BitBake does not attempt to build.
+                    Instead, BitBake assumes these recipes have already been
+                    built.
+                </para>
+
+                <para>
+                    In OpenEmbedded Core, <filename>ASSUME_PROVIDED</filename>
+                    mostly specifies native tools that should not be built.
+                    An example is <filename>git-native</filename>, which when
+                    specified, allows for the Git binary from the host to be
+                    used rather than building <filename>git-native</filename>.
                 </para>
             </glossdef>
          </glossentry>
@@ -898,11 +910,23 @@
         <glossentry id='var-BINCONFIG'><glossterm>BINCONFIG</glossterm>
             <glossdef>
                 <para>
-                    Specifies binary configuration scripts to disable
-                    rather than installing them using
-                    <filename>pkg-config</filename>.
-                    The OpenEmbedded build system returns an error for the
-                    disabled scripts.
+                    When inheriting the
+                    <link linkend='ref-classes-binconfig-disabled'><filename>binconfig-disabled</filename></link>
+                    class, this variable specifies binary configuration
+                    scripts to disable in favor of using
+                    <filename>pkg-config</filename> to query the information.
+                    The <filename>binconfig-disabled</filename> class will
+                    modify the specified scripts to return an error so that
+                    calls to them can be easily found and replaced.
+                </para>
+
+                <para>
+                    To add multiple scripts, separate them by spaces.
+                    Here is an example from the <filename>libpng</filename>
+                    recipe:
+                    <literallayout class='monospaced'>
+     BINCONFIG = "${bindir}/libpng-config ${bindir}/libpng16-config"
+                    </literallayout>
                 </para>
             </glossdef>
         </glossentry>
@@ -2216,14 +2240,17 @@
         <glossentry id='var-DOC_COMPRESS'><glossterm>DOC_COMPRESS</glossterm>
             <glossdef>
                 <para>
-                    Sets the compression policy used when the OpenEmbedded
-                    build system compresses man pages and info pages.
-                    By default, the compression method used is gs (gzip).
+                    When inheriting <filename>compress_doc.bbclass</filename>
+                    from a recipe, this variable sets the compression policy
+                    used when the OpenEmbedded build system compresses man
+                    pages and info pages.
+                    By default, the compression method used is gz (gzip).
+                    Other policies available are xz and bz2.
                 </para>
 
                 <para>
-                    For information on how to use this variable, see the
-                    comments in the
+                    For information on policies and on how to use this
+                    variable, see the comments in the
                     <filename>compress_doc.bbclass</filename> file.
                 </para>
             </glossdef>
@@ -2235,10 +2262,15 @@
 
         <glossentry id='var-EFI_PROVIDER'><glossterm>EFI_PROVIDER</glossterm>
             <glossdef>
-                <para></para>
                 <para>
-                    Setting this variable to "gummiboot" causes the
-                    OpenEmbedded build system to use the Gummiboot bootloader.
+                    When building bootable images (i.e. where
+                    <filename>hddimg</filename> or <filename>vmdk</filename>
+                    is in
+                    <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link>),
+                    The <filename>EFI_PROVIDER</filename> variable specifies
+                    the EFI bootloader to use.
+                    The default is "grub-efi", but "gummiboot" can be used
+                    instead.
                 </para>
 
                 <para>
@@ -2246,11 +2278,6 @@
                     <link linkend='ref-classes-gummiboot'><filename>gummiboot</filename></link>
                     class for more information.
                 </para>
-
-                <para>
-                    For information on Gummiboot, see the
-                    <ulink url='https://wiki.archlinux.org/index.php/Gummiboot'>Gummiboot documentation</ulink>.
-                </para>
             </glossdef>
         </glossentry>
 
@@ -3069,7 +3096,11 @@
         <glossentry id='var-GUMMIBOOT_CFG'><glossterm>GUMMIBOOT_CFG</glossterm>
             <glossdef>
                 <para>
-                    Specifies the configuration file that should be used.
+                    When
+                    <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link>
+                    is set to "gummiboot", the
+                    <filename>GUMMIBOOT_CFG</filename> variable specifies the
+                    configuration file that should be used.
                     By default, the
                     <link linkend='ref-classes-gummiboot'><filename>gummiboot</filename></link>
                     class sets the <filename>GUMMIBOOT_CFG</filename> as
@@ -3081,7 +3112,7 @@
 
                 <para>
                     For information on Gummiboot, see the
-                    <ulink url='https://wiki.archlinux.org/index.php/Gummiboot'>Gummiboot documentation</ulink>.
+                    <ulink url='http://freedesktop.org/wiki/Software/gummiboot/'>Gummiboot documentation</ulink>.
                 </para>
             </glossdef>
         </glossentry>
@@ -3089,7 +3120,11 @@
         <glossentry id='var-GUMMIBOOT_ENTRIES'><glossterm>GUMMIBOOT_ENTRIES</glossterm>
             <glossdef>
                 <para>
-                    Specifies a list of entry files
+                    When
+                    <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link>
+                    is set to "gummiboot", the
+                    <filename>GUMMIBOOT_ENTRIES</filename> variable specifies
+                    a list of entry files
                     (<filename>*.conf</filename>) to be installed
                     containing one boot entry per file.
                     By default, the
@@ -3103,7 +3138,7 @@
 
                 <para>
                     For information on Gummiboot, see the
-                    <ulink url='https://wiki.archlinux.org/index.php/Gummiboot'>Gummiboot documentation</ulink>.
+                    <ulink url='http://freedesktop.org/wiki/Software/gummiboot/'>Gummiboot documentation</ulink>.
                 </para>
             </glossdef>
         </glossentry>
@@ -3111,7 +3146,11 @@
         <glossentry id='var-GUMMIBOOT_TIMEOUT'><glossterm>GUMMIBOOT_TIMEOUT</glossterm>
             <glossdef>
                 <para>
-                    Specifies the boot menu timeout in seconds.
+                    When
+                    <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link>
+                    is set to "gummiboot", the
+                    <filename>GUMMIBOOT_TIMEOUT</filename> variable specifies
+                    the boot menu timeout in seconds.
                     By default, the
                     <link linkend='ref-classes-gummiboot'><filename>gummiboot</filename></link>
                     class sets the <filename>GUMMIBOOT_TIMEOUT</filename> as
@@ -3123,7 +3162,7 @@
 
                 <para>
                     For information on Gummiboot, see the
-                    <ulink url='https://wiki.archlinux.org/index.php/Gummiboot'>Gummiboot documentation</ulink>.
+                    <ulink url='http://freedesktop.org/wiki/Software/gummiboot/'>Gummiboot documentation</ulink>.
                 </para>
             </glossdef>
         </glossentry>
@@ -5197,7 +5236,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
          <glossentry id='var-MACHINE_ESSENTIAL_EXTRA_RDEPENDS'><glossterm>MACHINE_ESSENTIAL_EXTRA_RDEPENDS</glossterm>
             <glossdef>
-                <para></para>
                 <para>
                     A list of required machine-specific packages to install as part of
                     the image being built.
@@ -5229,7 +5267,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
          <glossentry id='var-MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS'><glossterm>MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS</glossterm>
             <glossdef>
-                <para></para>
                 <para>
                     A list of recommended machine-specific packages to install as part of
                     the image being built.
@@ -5316,7 +5353,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
          <glossentry id='var-MACHINE_EXTRA_RRECOMMENDS'><glossterm>MACHINE_EXTRA_RRECOMMENDS</glossterm>
             <glossdef>
-                <para></para>
                 <para>
                     A list of machine-specific packages to install as part of the
                     image being built that are not essential for booting the machine.
@@ -7493,7 +7529,11 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
         <glossentry id='var-SANITY_REQUIRED_UTILITIES'><glossterm>SANITY_REQUIRED_UTILITIES</glossterm>
             <glossdef>
                 <para>
-                    Need a description here.
+                    Specifies a list of command-line utilities that should be
+                    checked for during the initial sanity checking process when
+                    running BitBake.
+                    If any of the utilities are not installed on the build host,
+                    then BitBake immediately exits with an error.
                 </para>
             </glossdef>
         </glossentry>
@@ -8088,7 +8128,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
         <glossentry id='var-SRC_URI_OVERRIDES_PACKAGE_ARCH'><glossterm>SRC_URI_OVERRIDES_PACKAGE_ARCH</glossterm>
             <glossdef>
-                <para></para>
                 <para>
                     By default, the OpenEmbedded build system automatically detects whether
                     <filename><link linkend='var-SRC_URI'>SRC_URI</link></filename>