diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 3148d0f154..2414d3b036 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -493,6 +493,14 @@
+ BB_NUMBER_THREADS
+
+ The maximum number of tasks BitBake should run in parallel at any one time.
+ If your host development system supports multiple cores a good rule of thumb
+ is to set this variable to twice the number of cores.
+
+
+
BBCLASSEXTEND
@@ -517,6 +525,124 @@
+ BBFILE_COLLECTIONS
+
+ Lists the names of configured layers.
+ These names are used to find the other BBFILE_*
+ variables.
+ Typically, each layer will append its name to this variable in its
+ conf/layer.conf file.
+
+
+
+
+ BBFILE_PATTERN
+
+ Variable that expands to match files from
+ BBFILES
+ in a particular layer.
+ This variable is used in the conf/layer.conf file and must
+ be suffixed with the name of the specific layer (e.g.
+ BBFILE_PATTERN_emenlow).
+
+
+
+ BBFILE_PRIORITY
+
+ Assigns the priority for recipe files in each layer.
+ This variable is useful in situations where the same recipe appears in
+ more than one layer.
+ Setting this variable allows you to prioritize a
+ layer against other layers that contain the same recipe - effectively
+ letting you control the precedence for the multiple layers.
+ The precedence established through this variable stands regardless of a
+ recipe's version
+ (PV variable).
+ For example, a layer that has a recipe with a higher PV value but for
+ which the BBFILE_PRIORITY is set to have a lower precedence still has a
+ lower precedence.
+ A larger value for the BBFILE_PRIORITY variable results in a higher
+ precedence.
+ For example, the value 6 has a higher precedence than the value 5.
+ If not specified, the BBFILE_PRIORITY variable is set based on layer
+ dependencies (see the
+ LAYERDEPENDS variable for
+ more information.
+ The default priority, if unspecified
+ for a layer with no dependencies, is the lowest defined priority + 1
+ (or 1 if no priorities are defined).
+
+ You can use the command bitbake-layers show_layers to list
+ all configured layers along with their priorities.
+
+
+
+
+ BBFILES
+
+ List of recipe files used by BitBake to build software.
+
+
+
+ BBINCLUDELOGS
+
+ Variable that controls how BitBake displays logs on build failure.
+
+
+
+ BBLAYERS
+
+ Lists the layers to enable during the build.
+ This variable is defined in the bblayers.conf configuration
+ file in the Build Directory.
+ Here is an example:
+
+ BBLAYERS = " \
+ /home/scottrif/poky/meta \
+ /home/scottrif/poky/meta-yocto \
+ /home/scottrif/poky/meta-yocto-bsp \
+ /home/scottrif/poky/meta-mykernel \
+ "
+
+ BBLAYERS_NON_REMOVABLE ?= " \
+ /home/scottrif/poky/meta \
+ /home/scottrif/poky/meta-yocto \
+ "
+
+ This example enables four layers, one of which is a custom, user-defined layer
+ named meta-mykernel.
+
+
+
+
+ BBLAYERS_NON_REMOVABLE
+
+Core layer for images cannot be removed
+ Lists core layers that cannot be removed from the
+ bblayers.conf file.
+ In order for BitBake to build your image, your
+ bblayers.conf file must include the
+ meta and meta-yocto
+ core layers.
+ Here is an example that shows these two layers listed in
+ the BBLAYERS_NON_REMOVABLE statement:
+
+ BBLAYERS = " \
+ /home/scottrif/poky/meta \
+ /home/scottrif/poky/meta-yocto \
+ /home/scottrif/poky/meta-yocto-bsp \
+ /home/scottrif/poky/meta-mykernel \
+ "
+
+ BBLAYERS_NON_REMOVABLE ?= " \
+ /home/scottrif/poky/meta \
+ /home/scottrif/poky/meta-yocto \
+ "
+
+
+
+
+
BBMASK
@@ -577,73 +703,6 @@
- BB_NUMBER_THREADS
-
- The maximum number of tasks BitBake should run in parallel at any one time.
- If your host development system supports multiple cores a good rule of thumb
- is to set this variable to twice the number of cores.
-
-
-
- BBFILE_COLLECTIONS
-
- Lists the names of configured layers.
- These names are used to find the other BBFILE_*
- variables.
- Typically, each layer will append its name to this variable in its
- conf/layer.conf file.
-
-
-
-
- BBFILE_PATTERN
-
- Variable that expands to match files from
- BBFILES
- in a particular layer.
- This variable is used in the conf/layer.conf file and must
- be suffixed with the name of the specific layer (e.g.
- BBFILE_PATTERN_emenlow).
-
-
-
- BBFILE_PRIORITY
-
- Assigns the priority for recipe files in each layer.
- This variable is useful in situations where the same recipe appears in
- more than one layer.
- Setting this variable allows you to prioritize a
- layer against other layers that contain the same recipe - effectively
- letting you control the precedence for the multiple layers.
- The precedence established through this variable stands regardless of a
- recipe's version
- (PV variable).
- For example, a layer that has a recipe with a higher PV value but for
- which the BBFILE_PRIORITY is set to have a lower precedence still has a
- lower precedence.
- A larger value for the BBFILE_PRIORITY variable results in a higher
- precedence.
- For example, the value 6 has a higher precedence than the value 5.
- If not specified, the BBFILE_PRIORITY variable is set based on layer
- dependencies (see the
- LAYERDEPENDS variable for
- more information.
- The default priority, if unspecified
- for a layer with no dependencies, is the lowest defined priority + 1
- (or 1 if no priorities are defined).
-
- You can use the command bitbake-layers show_layers to list
- all configured layers along with their priorities.
-
-
-
-
- BBFILES
-
- List of recipe files used by BitBake to build software.
-
-
-
BBPATHUsed by BitBake to locate .bbclass and configuration files.
@@ -651,65 +710,6 @@
- BBINCLUDELOGS
-
- Variable that controls how BitBake displays logs on build failure.
-
-
-
- BBLAYERS
-
- Lists the layers to enable during the build.
- This variable is defined in the bblayers.conf configuration
- file in the Build Directory.
- Here is an example:
-
- BBLAYERS = " \
- /home/scottrif/poky/meta \
- /home/scottrif/poky/meta-yocto \
- /home/scottrif/poky/meta-yocto-bsp \
- /home/scottrif/poky/meta-mykernel \
- "
-
- BBLAYERS_NON_REMOVABLE ?= " \
- /home/scottrif/poky/meta \
- /home/scottrif/poky/meta-yocto \
- "
-
- This example enables four layers, one of which is a custom, user-defined layer
- named meta-mykernel.
-
-
-
-
- BBLAYERS_NON_REMOVABLE
-
-Core layer for images cannot be removed
- Lists core layers that cannot be removed from the
- bblayers.conf file.
- In order for BitBake to build your image, your
- bblayers.conf file must include the
- meta and meta-yocto
- core layers.
- Here is an example that shows these two layers listed in
- the BBLAYERS_NON_REMOVABLE statement:
-
- BBLAYERS = " \
- /home/scottrif/poky/meta \
- /home/scottrif/poky/meta-yocto \
- /home/scottrif/poky/meta-yocto-bsp \
- /home/scottrif/poky/meta-mykernel \
- "
-
- BBLAYERS_NON_REMOVABLE ?= " \
- /home/scottrif/poky/meta \
- /home/scottrif/poky/meta-yocto \
- "
-
-
-
-
-
BINCONFIG_GLOB