diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 1e31e0a3ab..ec747bf5f9 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml @@ -16,7 +16,7 @@ A - B + B C D E @@ -64,14 +64,58 @@ B + B + + + The directory in which the Yocto Project build system places + generated objects during a recipe's build process. + By default, this directory is the same as the S + directory: + + B = ${WORKDIR}/${BPN}-{PV}/ + + You can separate the source directory (S) and the directory pointed to + by the B variable. + In general, autotools, recipes such as gcc, + and some kernel recipes separate these directories by default. + + + + BAD_RECOMMENDATIONS - A list of packages not to install despite being recommended by a recipe. + + A list of packages not to install despite being recommended by a recipe. Support for this variable exists only for images that use the - ipkg packaging system. + ipkg packaging system. + + BBCLASSEXTEND + + + Allows you to extend a recipe so that it builds variants of the software. + Common variants for recipes exist such as "natives" like quilt-native, + which is a copy of quilt built to run on the build system; + "crosses" such as gcc-cross, + which is a compiler built to run on the build machine but produces binaries + that run on the target MACHINE; + "nativesdk", which targets the SDK machine instead of MACHINE; + and "mulitlibs" in the form "multilib:<multilib_name>". + + + + To build a different variant of the recipe with a minimal amount of code, it usually + is as simple as adding the following to your recipe: + + BBCLASSEXTEND = "native nativesdk" + BBCLASSEXTEND = "multilib:<multilib_name>" + + + + + BBMASK Prevents BitBake from processing recipes and recipe append files.