handbook: Move into documentation directory

Signed-off-by: Richard Purdie <rpurdie@linux.intel.com>

1 files changed, 0 insertions, 879 deletions

diff --git a/handbook/ref-variables.xml b/handbook/ref-variables.xml
deleted file mode 100644
index 7e10808525..0000000000
--- a/handbook/ref-variables.xml
+++ /dev/null
@@ -1,879 +0,0 @@
-<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<!-- Dummy chapter -->
-<appendix id='ref-variables-glos'>
-
-<title>Reference: Variables Glossary</title>
-
-<para>
-    This section lists common variables used in Poky and gives an overview
-    of their function and contents.
-</para>
-
-<glossary id='ref-variables-glossary'>
-
-
-    <para>
-       <link linkend='var-glossary-a'>A</link> 
-       <link linkend='var-glossary-b'>B</link> 
-       <link linkend='var-glossary-c'>C</link> 
-       <link linkend='var-glossary-d'>D</link> 
-       <link linkend='var-glossary-e'>E</link> 
-       <link linkend='var-glossary-f'>F</link> 
-<!--               <link linkend='var-glossary-g'>G</link> -->
-       <link linkend='var-glossary-h'>H</link> 
-       <link linkend='var-glossary-i'>I</link> 
-<!--               <link linkend='var-glossary-j'>J</link> -->
-       <link linkend='var-glossary-k'>K</link>
-       <link linkend='var-glossary-l'>L</link> 
-       <link linkend='var-glossary-m'>M</link> 
-<!--               <link linkend='var-glossary-n'>N</link> -->
-<!--               <link linkend='var-glossary-o'>O</link> -->
-       <link linkend='var-glossary-p'>P</link> 
-<!--               <link linkend='var-glossary-q'>Q</link> -->
-       <link linkend='var-glossary-r'>R</link> 
-       <link linkend='var-glossary-s'>S</link> 
-       <link linkend='var-glossary-t'>T</link> 
-<!--               <link linkend='var-glossary-u'>U</link> -->
-<!--               <link linkend='var-glossary-v'>V</link> -->
-       <link linkend='var-glossary-w'>W</link> 
-<!--               <link linkend='var-glossary-x'>X</link> -->
-<!--               <link linkend='var-glossary-y'>Y</link> -->
-<!--               <link linkend='var-glossary-z'>Z</link>-->
-    </para>
-
-    <glossdiv id='var-glossary-a'><title>A</title>
-
-         <glossentry id='var-AUTHOR'><glossterm>AUTHOR</glossterm>
-            <glossdef>
-                <para>E-mail address to contact original author(s) - to
-                send patches, forward bugs...</para>
-            </glossdef>
-         </glossentry>
-
-        <glossentry id='var-AUTOREV'><glossterm>AUTOREV</glossterm>
-            <glossdef>
-                <para>Use current (newest) source revision - used with
-                    <glossterm><link linkend='var-SRCREV'>SRCREV</link></glossterm>
-                    variable.</para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-b'><title>B</title>
-
-        <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm>
-            <glossdef>
-                <para>The maximum number of tasks BitBake should run in parallel at any one time</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-BBFILES'><glossterm>BBFILES</glossterm>
-            <glossdef>
-                <para>List of recipes used by BitBake to build software</para>
-            </glossdef>
-        </glossentry>
-
-        <!-- BBPATH is not a usable variable in .bb files and should not be listed here -->
-
-        <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm>
-            <glossdef>
-                <para>Variable which controls how BitBake displays logs on build failure.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-BPN'><glossterm>BPN</glossterm>
-            <glossdef>
-                <para>Bare name of package with any suffixes like -cross -native
-                removed.  </para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-c'><title>C</title>
-
-        <glossentry id='var-CFLAGS'><glossterm>CFLAGS</glossterm>
-            <glossdef>
-                <para>
-                    Flags passed to C compiler for the target system. Evaluates to the same 
-                    as <link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link>.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-COMPATIBLE_MACHINE'><glossterm>COMPATIBLE_MACHINE</glossterm>
-            <glossdef>
-                <para>A regular expression which evalutates to match the machines the recipe 
-                works with. It stops recipes being run on machines they're incompatible with, 
-                which is partciuarly useful with kernels. It also helps to increase parsing 
-                speed as further parsing of the recipe is skipped as if it found the current
-                machine is not compatible.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-CONFIG_SITE'><glossterm>CONFIG_SITE</glossterm>
-            <glossdef>
-                <para>
-                    A list of files which contains autoconf test results relevant 
-                    to the current build. This variable is used by the autotools utilities 
-                    when running configure.
-                </para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-d'><title>D</title>
-
-        <glossentry id='var-D'><glossterm>D</glossterm>
-            <glossdef>
-                <para>Destination directory</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DEBUG_BUILD'><glossterm>DEBUG_BUILD</glossterm>
-            <glossdef>
-                <para>
-                    Build packages with debugging information. This influences the value 
-                    <link linkend='var-SELECTED_OPTIMIZATION'>SELECTED_OPTIMIZATION</link> 
-                    takes.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DEBUG_OPTIMIZATION'><glossterm>DEBUG_OPTIMIZATION</glossterm>
-            <glossdef>
-                <para>
-                    The options to pass in <link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link>
-                    and <link linkend='var-CFLAGS'>CFLAGS</link> when compiling a system for debugging.
-                    This defaults to "-O -fno-omit-frame-pointer -g".
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DEFAULT_PREFERENCE'><glossterm>DEFAULT_PREFERENCE</glossterm>
-            <glossdef>
-                <para>Priority of recipe</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DEPENDS'><glossterm>DEPENDS</glossterm>
-            <glossdef>
-                <para>
-                    A list of build time dependencies for a given recipe. These indicate 
-                    recipes that must have staged before this recipe can configure.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DESCRIPTION'><glossterm>DESCRIPTION</glossterm>
-            <glossdef>
-                <para>Package description used by package
-                    managers</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DESTDIR'><glossterm>DESTDIR</glossterm>
-            <glossdef>
-                <para>Destination directory</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DISTRO'><glossterm>DISTRO</glossterm>
-            <glossdef>
-                <para>Short name of distribution</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DISTRO_EXTRA_RDEPENDS'><glossterm>DISTRO_EXTRA_RDEPENDS</glossterm>
-            <glossdef>
-                <para>List of packages required by distribution.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DISTRO_EXTRA_RRECOMMENDS'><glossterm>DISTRO_EXTRA_RRECOMMENDS</glossterm>
-            <glossdef>
-                <para>List of packages which extend usability of
-                    image. Those packages will be automatically
-                    installed but can be removed by user.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DISTRO_FEATURES'><glossterm>DISTRO_FEATURES</glossterm>
-            <glossdef>
-                <para>Features of the distribution.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DISTRO_NAME'><glossterm>DISTRO_NAME</glossterm>
-            <glossdef>
-                <para>Long name of distribution</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DISTRO_PN_ALIAS'><glossterm>DISTRO_PN_ALIAS</glossterm>
-            <glossdef>
-                <para>Alias names of the recipe in various Linux distributions.  </para>
-                <para>More information in 
-                    <link
-                        linkend='usingpoky-configuring-DISTRO_PN_ALIAS'>
-                        Configuring the DISTRO_PN_ALIAS variable section
-                    </link>
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DISTRO_VERSION'><glossterm>DISTRO_VERSION</glossterm>
-            <glossdef>
-                <para>Version of distribution</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-DL_DIR'><glossterm>DL_DIR</glossterm>
-            <glossdef>
-                <para>Directory where all fetched sources will be stored</para>
-            </glossdef>
-
-        </glossentry>
-    </glossdiv>
-
-    <glossdiv id='var-glossary-e'><title>E</title>
-
-        <glossentry id='var-ENABLE_BINARY_LOCALE_GENERATION'><glossterm>ENABLE_BINARY_LOCALE_GENERATION</glossterm>
-            <glossdef>
-                <para>Variable which control which locales for glibc are
-                to be generated during build (useful if target device
-                has 64M RAM or less)</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-EXTRA_OECMAKE'><glossterm>EXTRA_OECMAKE</glossterm>
-            <glossdef>
-                <para>Additional cmake options</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-EXTRA_OECONF'><glossterm>EXTRA_OECONF</glossterm>
-            <glossdef>
-                <para>Additional 'configure' script options</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-EXTRA_OEMAKE'><glossterm>EXTRA_OEMAKE</glossterm>
-            <glossdef>
-                <para>Additional GNU make options</para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-f'><title>F</title>
-
-        <glossentry id='var-FILES'><glossterm>FILES</glossterm>
-            <glossdef>
-                <para>list of directories/files which will be placed
-                    in packages</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-FULL_OPTIMIZATION'><glossterm>FULL_OPTIMIZATION</glossterm>
-            <glossdef>
-                <para>
-                    The options to pass in <link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link>
-                    and <link linkend='var-CFLAGS'>CFLAGS</link> when compiling an optimised system.
-                    This defaults to "-fexpensive-optimizations -fomit-frame-pointer -frename-registers -O2".
-                </para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-<!--            <glossdiv id='var-glossary-g'><title>G</title>-->
-<!--            </glossdiv>-->
-
-    <glossdiv id='var-glossary-h'><title>H</title>
-
-        <glossentry id='var-HOMEPAGE'><glossterm>HOMEPAGE</glossterm>
-            <glossdef>
-                <para>Website where more info about package can be found</para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-i'><title>I</title>
-
-        <glossentry id='var-IMAGE_FEATURES'><glossterm>IMAGE_FEATURES</glossterm>
-            <glossdef>
-                <para><link linkend="ref-features-image">List of
-                features</link> present in resulting images</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-IMAGE_FSTYPES'><glossterm>IMAGE_FSTYPES</glossterm>
-            <glossdef>
-                <para>Formats of rootfs images which we want to have
-                    created</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-IMAGE_INSTALL'><glossterm>IMAGE_INSTALL</glossterm>
-            <glossdef>
-                <para>List of packages used to build image</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-INHIBIT_PACKAGE_STRIP'><glossterm>INHIBIT_PACKAGE_STRIP</glossterm>
-            <glossdef>
-                <para>
-                    This variable causes the build to not strip binaries in
-                    resulting packages.
-                </para>
-            </glossdef>
-        </glossentry>
-
-
-        <glossentry id='var-INHERIT'><glossterm>INHERIT</glossterm>
-            <glossdef>
-                <para>
-                    This variable causes the named class to be inherited at 
-                    this point during parsing. Its only valid in configuration 
-                    files.
-                </para>
-            </glossdef>
-        </glossentry>
-
-
-        <glossentry id='var-INITSCRIPT_PACKAGES'><glossterm>INITSCRIPT_PACKAGES</glossterm>
-            <glossdef>
-                <para>
-                    Scope: Used in recipes when using update-rc.d.bbclass. Optional, defaults to PN.
-                </para>
-                <para>
-                    A list of the packages which contain initscripts. If multiple 
-                    packages are specified you need to append the package name 
-                    to the other INITSCRIPT_* as an override.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-INITSCRIPT_NAME'><glossterm>INITSCRIPT_NAME</glossterm>
-            <glossdef>
-                <para>
-                    Scope: Used in recipes when using update-rc.d.bbclass. Mandatory.
-                </para>
-                <para>
-                    The filename of the initscript (as installed to ${etcdir}/init.d).
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-INITSCRIPT_PARAMS'><glossterm>INITSCRIPT_PARAMS</glossterm>
-            <glossdef>
-                <para>
-                    Scope: Used in recipes when using update-rc.d.bbclass. Mandatory.
-                </para>
-                <para>
-                    Specifies the options to pass to update-rc.d. An example is
-                     "start 99 5 2 . stop 20 0 1 6 ." which gives the script a 
-                    runlevel of 99, starts the script in initlevels 2 and 5 and 
-                     stops it in levels 0, 1 and 6. 
-                </para>
-            </glossdef>
-        </glossentry>
-
-
-    </glossdiv>
-
-<!--            <glossdiv id='var-glossary-j'><title>J</title>-->
-<!--            </glossdiv>-->
-
-   <glossdiv id='var-glossary-k'><title>K</title>
-
-        <glossentry id='var-KERNEL_IMAGETYPE'><glossterm>KERNEL_IMAGETYPE</glossterm>
-            <glossdef>
-                <para>The type of kernel to build for a device, usually set by the 
-                machine configuration files and defaults to "zImage". This is used 
-                when building the kernel and is passed to "make" as the target to 
-                build.</para>
-            </glossdef>
-        </glossentry>
-
-   </glossdiv>
-
-    <glossdiv id='var-glossary-l'><title>L</title>
-
-        <glossentry id='var-LAYERDIR'><glossterm>LAYERDIR</glossterm>
-            <glossdef>
-                <para>When used inside a layer.conf gives the path of the
-                current layer. This variable requires immediate expansion
-                (see the Bitbake manual) as lazy expansion can result in
-                the expansion happening in the wrong directory and therefore
-                giving the wrong value.</para>
-            </glossdef>
-        </glossentry>
-        <glossentry id='var-LICENSE'><glossterm>LICENSE</glossterm>
-            <glossdef>
-                <para>List of package source licenses.</para>
-            </glossdef>
-        </glossentry>
-        <glossentry id='var-LIC_FILES_CHKSUM'><glossterm>LIC_FILES_CHKSUM</glossterm>
-            <glossdef>
-                <para>Checksums of the license text in the recipe source code.
-                </para>
-                <para>This variable tracks changes in license text of the source
-                code files. If the license text is changed, it will trigger the build
-                failure, which gives developer an opportunity to review any 
-                license change</para>
-                <para> This is an optional variable now, and the plan is to make
-                it a required variable in the future </para>
-                <para>See "meta/package/zlib/zlib_${PV}.bb" file for an example</para>
-
-                <para>More information in <link
-                    linkend='usingpoky-configuring-LIC_FILES_CHKSUM'>
-                    Configuring the LIC_FILES_CHKSUM variable section</link></para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-m'><title>M</title>
-
-         <glossentry id='var-MACHINE'><glossterm>MACHINE</glossterm>
-            <glossdef>
-                <para>Target device</para>
-            </glossdef>
-         </glossentry>
-
-         <glossentry id='var-MACHINE_ESSENTIAL_RDEPENDS'><glossterm>MACHINE_ESSENTIAL_RDEPENDS</glossterm>
-            <glossdef>
-                <para>List of packages required to boot device</para>
-            </glossdef>
-         </glossentry>
-
-         <glossentry id='var-MACHINE_ESSENTIAL_RRECOMMENDS'><glossterm>MACHINE_ESSENTIAL_RRECOMMENDS</glossterm>
-            <glossdef>
-                <para>List of packages required to boot device (usually
-                    additional kernel modules)</para>
-            </glossdef>
-        </glossentry>
-
-         <glossentry id='var-MACHINE_EXTRA_RDEPENDS'><glossterm>MACHINE_EXTRA_RDEPENDS</glossterm>
-            <glossdef>
-                <para>List of packages required to use device</para>
-            </glossdef>
-         </glossentry>
-
-         <glossentry id='var-MACHINE_EXTRA_RRECOMMENDS'><glossterm>MACHINE_EXTRA_RRECOMMNEDS</glossterm>
-            <glossdef>
-                <para>List of packages useful to use device (for example
-                    additional kernel modules)</para>
-            </glossdef>
-         </glossentry>
-
-         <glossentry id='var-MACHINE_FEATURES'><glossterm>MACHINE_FEATURES</glossterm>
-            <glossdef>
-                <para>List of device features - defined in <link
-                    linkend='ref-features-machine'>machine
-                    features section</link></para>
-            </glossdef>
-         </glossentry>
-
-        <glossentry id='var-MAINTAINER'><glossterm>MAINTAINER</glossterm>
-            <glossdef>
-                <para>E-mail of distribution maintainer</para>
-            </glossdef>
-        </glossentry>
-    </glossdiv>
-
-<!--            <glossdiv id='var-glossary-n'><title>N</title>-->
-<!--            </glossdiv>-->
-
-<!--            <glossdiv id='var-glossary-o'><title>O</title>-->
-<!--            </glossdiv>-->
-
-    <glossdiv id='var-glossary-p'><title>P</title>
-
-        <glossentry id='var-PACKAGE_ARCH'><glossterm>PACKAGE_ARCH</glossterm>
-            <glossdef>
-                <para>Architecture of resulting package</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PACKAGE_CLASSES'><glossterm>PACKAGE_CLASSES</glossterm>
-            <glossdef>
-                <para>List of resulting packages formats</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PACKAGE_EXTRA_ARCHS'><glossterm>PACKAGE_EXTRA_ARCHS</glossterm>
-            <glossdef>
-                <para>List of architectures compatible with device
-                    CPU. Usable when build is done for few different
-                    devices with misc processors (like XScale and
-                    ARM926-EJS)</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PACKAGES'><glossterm>PACKAGES</glossterm>
-            <glossdef>
-                <para>List of packages to be created from recipe.
-                    The default value is "${PN}-dbg ${PN} ${PN}-doc ${PN}-dev"</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE</glossterm>
-            <glossdef>
-                <para>Extra options that are passed to the make command during the 
-                    compile tasks. This is usually of the form '-j 4' where the number
-                    represents the maximum number of parallel threads make can run.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PN'><glossterm>PN</glossterm>
-            <glossdef>
-                <para>Name of package.
-                    </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PR'><glossterm>PR</glossterm>
-            <glossdef>
-                <para>Revision of package.
-                    </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PV'><glossterm>PV</glossterm>
-            <glossdef>
-                <para>Version of package.
-                    The default value is "1.0"</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PE'><glossterm>PE</glossterm>
-            <glossdef>
-                <para>
-                    Epoch of the package. The default value is "0". The field is used 
-                    to make upgrades possible when the versioning scheme changes in 
-                    some backwards incompatible way.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PREFERRED_PROVIDER'><glossterm>PREFERRED_PROVIDER</glossterm>
-            <glossdef>
-                <para>If multiple recipes provide an item, this variable
-                    determines which one should be given preference. It 
-                    should be set to the "$PN" of the recipe to be preferred.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-PREFERRED_VERSION'><glossterm>PREFERRED_VERSION</glossterm>
-            <glossdef>
-                <para>
-                    If there are multiple versions of recipe available, this
-                    variable determines which one should be given preference. It
-                    should be set to the "$PV" of the recipe to be preferred.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-POKY_EXTRA_INSTALL'><glossterm>POKY_EXTRA_INSTALL</glossterm>
-            <glossdef>
-                <para>List of packages to be added to the image. This should
-                only be set in <filename>local.conf</filename>.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-POKYLIBC'><glossterm>POKYLIBC</glossterm>
-            <glossdef>
-                <para>Libc implementation selector - glibc, eglibc, or uclibc can be selected.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-POKYMODE'><glossterm>POKYMODE</glossterm>
-            <glossdef>
-                <para>Toolchain selector. It can be external toolchain
-                built from Poky or few supported combinations of
-                upstream GCC or CodeSourcery Labs toolchain.</para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-<!--            <glossdiv id='var-glossary-q'><title>Q</title>-->
-<!--            </glossdiv>-->
-
-    <glossdiv id='var-glossary-r'><title>R</title>
-
-        <glossentry id='var-RCONFLICTS'><glossterm>RCONFLICTS</glossterm>
-            <glossdef>
-                <para>List of packages which conflict with this
-                    one. Package will not be installed if they are not
-                    removed first.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-RDEPENDS'><glossterm>RDEPENDS</glossterm>
-            <glossdef>
-                <para>
-                    A list of run-time dependencies for a package. These packages 
-                    need to be installed alongside the package it applies to so 
-                    the package will run correctly, an example is a perl script
-                    which would rdepend on perl. Since this variable applies to 
-                    output packages there would usually be an override attached 
-                    to this variable like RDEPENDS_${PN}-dev. Names in this field 
-                    should be as they are in <link linkend='var-PACKAGES'>PACKAGES
-                    </link> namespace before any renaming of the output package
-                    by classes like debian.bbclass.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-ROOT_FLASH_SIZE'><glossterm>ROOT_FLASH_SIZE</glossterm>
-            <glossdef>
-                <para>Size of rootfs in megabytes</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-RRECOMMENDS'><glossterm>RRECOMMENDS</glossterm>
-            <glossdef>
-                <para>List of packages which extend usability of the
-                    package. Those packages will be automatically
-                    installed but can be removed by user.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-RREPLACES'><glossterm>RREPLACES</glossterm>
-            <glossdef>
-                <para>List of packages which are replaced with this
-                    one.</para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-s'><title>S</title>
-
-        <glossentry id='var-S'><glossterm>S</glossterm>
-            <glossdef>
-                <para>
-                    Path to unpacked sources (by default:
-                    "${<link linkend='var-WORKDIR'>WORKDIR</link>}/${<link linkend='var-PN'>PN</link>}-${<link linkend='var-PV'>PV</link>}")
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SECTION'><glossterm>SECTION</glossterm>
-            <glossdef>
-                <para>Section where package should be put - used
-                    by package managers</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SELECTED_OPTIMIZATION'><glossterm>SELECTED_OPTIMIZATION</glossterm>
-            <glossdef>
-                <para>
-                    The variable takes the value of <link linkend='var-FULL_OPTIMIZATION'>FULL_OPTIMIZATION</link>
-                    unless <link linkend='var-DEBUG_BUILD'>DEBUG_BUILD</link> = "1" in which case 
-                    <link linkend='var-DEBUG_OPTIMIZATION'>DEBUG_OPTIMIZATION</link> is used.
-                </para>
-            </glossdef>
-        </glossentry>
-
-
-        <glossentry id='var-SERIAL_CONSOLE'><glossterm>SERIAL_CONSOLE</glossterm>
-            <glossdef>
-                <para>Speed and device for serial port used to attach
-                    serial console. This is given to kernel as "console"
-                    param and after boot getty is started on that port
-                    so remote login is possible.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SHELLCMDS'><glossterm>SHELLCMDS</glossterm>
-            <glossdef>
-                <para>
-                    A list of commands to run within the a shell, used by <glossterm><link
-                    linkend='var-TERMCMDRUN'>TERMCMDRUN</link></glossterm>.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SITEINFO_ENDIANESS'><glossterm>SITEINFO_ENDIANESS</glossterm>
-            <glossdef>
-                <para>
-                    Contains "le" for little-endian or "be" for big-endian depending 
-                    on the endian byte order of the target system.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SITEINFO_BITS'><glossterm>SITEINFO_BITS</glossterm>
-            <glossdef>
-                <para>
-                    Contains "32" or "64" depending on the number of bits for the 
-                    CPU of the target system.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SRC_URI'><glossterm>SRC_URI</glossterm>
-            <glossdef>
-                <para>List of source files (local or remote ones)</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SRC_URI_OVERRIDES_PACKAGE_ARCH'><glossterm>SRC_URI_OVERRIDES_PACKAGE_ARCH</glossterm>
-            <glossdef>
-                <para>
-                    By default there is code which automatically detects whether 
-                    <glossterm><link linkend='var-SRC_URI'>SRC_URI</link></glossterm>  
-                    contains files which are machine specific and if this is the case it
-                    automatically changes 
-                    <glossterm><link linkend='var-PACKAGE_ARCH'>PACKAGE_ARCH</link></glossterm>. 
-                    Setting this variable to "0" disables that behaviour.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SRCDATE'><glossterm>SRCDATE</glossterm>
-            <glossdef>
-                <para>
-                    Date of source code used to build package (if it was fetched
-                    from SCM).
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SRCREV'><glossterm>SRCREV</glossterm>
-            <glossdef>
-                <para>
-                    Revision of source code used to build package (Subversion,
-                    GIT, Bazaar only).
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-STAGING_KERNEL_DIR'><glossterm>STAGING_KERNEL_DIR</glossterm>
-            <glossdef>
-                <para>
-                    Directory with kernel headers required to build out-of-tree
-                    modules.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-STAMPS'><glossterm>STAMPS</glossterm>
-            <glossdef>
-                <para>
-                    Directory (usually TMPDIR/stamps) with timestamps of
-                    executed tasks.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-SUMMARY'><glossterm>SUMMARY</glossterm>
-            <glossdef>
-                <para>Short (72 char suggested) Summary of binary package for packaging sytems such as ipkg, rpm or debian, inherits DESCRIPTION by default</para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-    <glossdiv id='var-glossary-t'><title>T</title>
-
-        <glossentry id='var-TARGET_ARCH'><glossterm>TARGET_ARCH</glossterm>
-            <glossdef>
-                <para>The architecture of the device we're building for. 
-                A number of values are possible but Poky primarily supports
-                "arm" and "i586".</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-TARGET_CFLAGS'><glossterm>TARGET_CFLAGS</glossterm>
-            <glossdef>
-                <para>
-                    Flags passed to C compiler for the target system. Evaluates to the same 
-                    as <link linkend='var-CFLAGS'>CFLAGS</link>.
-                </para>
-            </glossdef>
-        </glossentry>
-
-
-        <glossentry id='var-TARGET_FPU'><glossterm>TARGET_FPU</glossterm>
-            <glossdef>
-                <para>Method of handling FPU code. For FPU-less targets
-                (most of ARM cpus) it has to be set to "soft" otherwise
-                kernel emulation will get used which will result in
-                performance penalty.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-TARGET_OS'><glossterm>TARGET_OS</glossterm>
-            <glossdef>
-                <para>Type of target operating system. Can be "linux"
-                for glibc based system, "linux-uclibc" for uClibc. For
-                ARM/EABI targets there are also "linux-gnueabi" and
-                "linux-uclibc-gnueabi" values possible.</para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-TERMCMD'><glossterm>TERMCMD</glossterm>
-            <glossdef>
-                <para>
-                    This command is used by bitbake to lauch a terminal window with a 
-                    shell. The shell is unspecified so the user's default shell is used. 
-                    By default it is set to <command>gnome-terminal</command> but it can 
-                    be any X11 terminal application or terminal multiplexers like screen.
-                </para>
-            </glossdef>
-        </glossentry>
-
-        <glossentry id='var-TERMCMDRUN'><glossterm>TERMCMDRUN</glossterm>
-            <glossdef>
-                <para>
-                    This command is similar to <glossterm><link
-                linkend='var-TERMCMD'>TERMCMD</link></glossterm> however instead of the users shell it runs the command specified by the <glossterm><link
-                linkend='var-SHELLCMDS'>SHELLCMDS</link></glossterm> variable.
-                </para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-<!--            <glossdiv id='var-glossary-u'><title>U</title>-->
-<!--            </glossdiv>-->
-
-<!--            <glossdiv id='var-glossary-v'><title>V</title>-->
-<!--            </glossdiv>-->
-
-    <glossdiv id='var-glossary-w'><title>W</title>
-
-        <glossentry id='var-WORKDIR'><glossterm>WORKDIR</glossterm>
-            <glossdef>
-                <para>Path to directory in tmp/work/ where package
-                    will be built.</para>
-            </glossdef>
-        </glossentry>
-
-    </glossdiv>
-
-<!--            <glossdiv id='var-glossary-x'><title>X</title>-->
-<!--            </glossdiv>-->
-
-<!--            <glossdiv id='var-glossary-y'><title>Y</title>-->
-<!--            </glossdiv>-->
-
-<!--            <glossdiv id='var-glossary-z'><title>Z</title>-->
-<!--            </glossdiv>-->
-
-</glossary>
-</appendix>
-<!-- 
-vim: expandtab tw=80 ts=4 
--->