summaryrefslogtreecommitdiffstats
path: root/bitbake/doc
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-12-26 16:22:32 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-12-27 13:08:30 +0000
commit8615d47a3a39e78fb7cf29ee92203d18a2439a3b (patch)
tree9f4b653bc903f04371ffce8320499d6ca22d4408 /bitbake/doc
parentad4bdc680a2eb28b1bc6dfd937058c89006d2908 (diff)
downloadpoky-8615d47a3a39e78fb7cf29ee92203d18a2439a3b.tar.gz
bitbake: bitbake-user-manual: Created unique tags for glossary variables.
Fixes [YOCTO #12399] The bug was to get the BitBake User Manual into the YP Mega-manual. All the changes here create unique tags used with variables in the BitBake Manual. Prior to the fix, tags were identical between like variables in the YP reference manual and the BitBake User Manual. The reason for this is because when I created the BitBake manual's glossary, it was a cut-and-paste operation to get the bulk of the work started. At the time, the BitBake User Manual was not a part of the Mega-manual. Once we decided to include the BitBake User Manual as part of the Mega-Manual, building the mega-manual produced warnings for all these duplicate links. To fix, I have updated the variable tags in the BitBake User Manual to use the following form: 'var-bb-<variable_name>' The tags used in the YP ref-manual follow this form (original): 'var-<variable_name>' (Bitbake rev: fb6de2057aae3fbdf37f007d2e47794b332020e1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake/doc')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-execution.xml78
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml48
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml28
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml2
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml78
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml422
6 files changed, 328 insertions, 328 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-execution.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-execution.xml
index f1caaecd2d..46dafeee30 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-execution.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-execution.xml
@@ -31,7 +31,7 @@
31 <para> 31 <para>
32 Prior to executing BitBake, you should take advantage of available 32 Prior to executing BitBake, you should take advantage of available
33 parallel thread execution on your build host by setting the 33 parallel thread execution on your build host by setting the
34 <link linkend='var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link> 34 <link linkend='var-bb-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link>
35 variable in your project's <filename>local.conf</filename> 35 variable in your project's <filename>local.conf</filename>
36 configuration file. 36 configuration file.
37 </para> 37 </para>
@@ -87,9 +87,9 @@
87 <para> 87 <para>
88 The <filename>layer.conf</filename> files are used to 88 The <filename>layer.conf</filename> files are used to
89 construct key variables such as 89 construct key variables such as
90 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> 90 <link linkend='var-bb-BBPATH'><filename>BBPATH</filename></link>
91 and 91 and
92 <link linkend='var-BBFILES'><filename>BBFILES</filename></link>. 92 <link linkend='var-bb-BBFILES'><filename>BBFILES</filename></link>.
93 <filename>BBPATH</filename> is used to search for 93 <filename>BBPATH</filename> is used to search for
94 configuration and class files under the 94 configuration and class files under the
95 <filename>conf</filename> and <filename>classes</filename> 95 <filename>conf</filename> and <filename>classes</filename>
@@ -117,19 +117,19 @@
117 at certain variables, including: 117 at certain variables, including:
118 <itemizedlist> 118 <itemizedlist>
119 <listitem><para> 119 <listitem><para>
120 <link linkend='var-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link> 120 <link linkend='var-bb-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link>
121 </para></listitem> 121 </para></listitem>
122 <listitem><para> 122 <listitem><para>
123 <link linkend='var-BB_ENV_EXTRAWHITE'><filename>BB_ENV_EXTRAWHITE</filename></link> 123 <link linkend='var-bb-BB_ENV_EXTRAWHITE'><filename>BB_ENV_EXTRAWHITE</filename></link>
124 </para></listitem> 124 </para></listitem>
125 <listitem><para> 125 <listitem><para>
126 <link linkend='var-BB_PRESERVE_ENV'><filename>BB_PRESERVE_ENV</filename></link> 126 <link linkend='var-bb-BB_PRESERVE_ENV'><filename>BB_PRESERVE_ENV</filename></link>
127 </para></listitem> 127 </para></listitem>
128 <listitem><para> 128 <listitem><para>
129 <link linkend='var-BB_ORIGENV'><filename>BB_ORIGENV</filename></link> 129 <link linkend='var-bb-BB_ORIGENV'><filename>BB_ORIGENV</filename></link>
130 </para></listitem> 130 </para></listitem>
131 <listitem><para> 131 <listitem><para>
132 <link linkend='var-BITBAKE_UI'><filename>BITBAKE_UI</filename></link> 132 <link linkend='var-bb-BITBAKE_UI'><filename>BITBAKE_UI</filename></link>
133 </para></listitem> 133 </para></listitem>
134 </itemizedlist> 134 </itemizedlist>
135 The first four variables in this list relate to how BitBake treats shell 135 The first four variables in this list relate to how BitBake treats shell
@@ -156,7 +156,7 @@
156 BitBake first searches the current working directory for an 156 BitBake first searches the current working directory for an
157 optional <filename>conf/bblayers.conf</filename> configuration file. 157 optional <filename>conf/bblayers.conf</filename> configuration file.
158 This file is expected to contain a 158 This file is expected to contain a
159 <link linkend='var-BBLAYERS'><filename>BBLAYERS</filename></link> 159 <link linkend='var-bb-BBLAYERS'><filename>BBLAYERS</filename></link>
160 variable that is a space-delimited list of 'layer' directories. 160 variable that is a space-delimited list of 'layer' directories.
161 Recall that if BitBake cannot find a <filename>bblayers.conf</filename> 161 Recall that if BitBake cannot find a <filename>bblayers.conf</filename>
162 file, then it is assumed the user has set the <filename>BBPATH</filename> 162 file, then it is assumed the user has set the <filename>BBPATH</filename>
@@ -166,10 +166,10 @@
166 <para> 166 <para>
167 For each directory (layer) in this list, a <filename>conf/layer.conf</filename> 167 For each directory (layer) in this list, a <filename>conf/layer.conf</filename>
168 file is located and parsed with the 168 file is located and parsed with the
169 <link linkend='var-LAYERDIR'><filename>LAYERDIR</filename></link> 169 <link linkend='var-bb-LAYERDIR'><filename>LAYERDIR</filename></link>
170 variable being set to the directory where the layer was found. 170 variable being set to the directory where the layer was found.
171 The idea is these files automatically set up 171 The idea is these files automatically set up
172 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> 172 <link linkend='var-bb-BBPATH'><filename>BBPATH</filename></link>
173 and other variables correctly for a given build directory. 173 and other variables correctly for a given build directory.
174 </para> 174 </para>
175 175
@@ -189,7 +189,7 @@
189 depending on the environment variables previously 189 depending on the environment variables previously
190 mentioned or set in the configuration files. 190 mentioned or set in the configuration files.
191 The 191 The
192 "<link linkend='ref-variables-glos'>Variables Glossary</link>" 192 "<link linkend='ref-bb-variables-glos'>Variables Glossary</link>"
193 chapter presents a full list of variables. 193 chapter presents a full list of variables.
194 </para> 194 </para>
195 195
@@ -204,7 +204,7 @@
204 <para> 204 <para>
205 The <filename>base.bbclass</filename> file is always included. 205 The <filename>base.bbclass</filename> file is always included.
206 Other classes that are specified in the configuration using the 206 Other classes that are specified in the configuration using the
207 <link linkend='var-INHERIT'><filename>INHERIT</filename></link> 207 <link linkend='var-bb-INHERIT'><filename>INHERIT</filename></link>
208 variable are also included. 208 variable are also included.
209 BitBake searches for class files in a 209 BitBake searches for class files in a
210 <filename>classes</filename> subdirectory under 210 <filename>classes</filename> subdirectory under
@@ -270,7 +270,7 @@
270 270
271 <para> 271 <para>
272 During the configuration phase, BitBake will have set 272 During the configuration phase, BitBake will have set
273 <link linkend='var-BBFILES'><filename>BBFILES</filename></link>. 273 <link linkend='var-bb-BBFILES'><filename>BBFILES</filename></link>.
274 BitBake now uses it to construct a list of recipes to parse, 274 BitBake now uses it to construct a list of recipes to parse,
275 along with any append files (<filename>.bbappend</filename>) 275 along with any append files (<filename>.bbappend</filename>)
276 to apply. 276 to apply.
@@ -292,7 +292,7 @@
292 Any inherit statements cause BitBake to find and 292 Any inherit statements cause BitBake to find and
293 then parse class files (<filename>.bbclass</filename>) 293 then parse class files (<filename>.bbclass</filename>)
294 using 294 using
295 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> 295 <link linkend='var-bb-BBPATH'><filename>BBPATH</filename></link>
296 as the search path. 296 as the search path.
297 Finally, BitBake parses in order any append files found in 297 Finally, BitBake parses in order any append files found in
298 <filename>BBFILES</filename>. 298 <filename>BBFILES</filename>.
@@ -303,8 +303,8 @@
303 pieces of metadata. 303 pieces of metadata.
304 For example, in <filename>bitbake.conf</filename> the recipe 304 For example, in <filename>bitbake.conf</filename> the recipe
305 name and version are used to set the variables 305 name and version are used to set the variables
306 <link linkend='var-PN'><filename>PN</filename></link> and 306 <link linkend='var-bb-PN'><filename>PN</filename></link> and
307 <link linkend='var-PV'><filename>PV</filename></link>: 307 <link linkend='var-bb-PV'><filename>PV</filename></link>:
308 <literallayout class='monospaced'> 308 <literallayout class='monospaced'>
309 PN = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[0] or 'defaultpkgname'}" 309 PN = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[0] or 'defaultpkgname'}"
310 PV = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[1] or '1.0'}" 310 PV = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[1] or '1.0'}"
@@ -336,7 +336,7 @@
336 recipe information. 336 recipe information.
337 The validity of this cache is determined by first computing a 337 The validity of this cache is determined by first computing a
338 checksum of the base configuration data (see 338 checksum of the base configuration data (see
339 <link linkend='var-BB_HASHCONFIG_WHITELIST'><filename>BB_HASHCONFIG_WHITELIST</filename></link>) 339 <link linkend='var-bb-BB_HASHCONFIG_WHITELIST'><filename>BB_HASHCONFIG_WHITELIST</filename></link>)
340 and then checking if the checksum matches. 340 and then checking if the checksum matches.
341 If that checksum matches what is in the cache and the recipe 341 If that checksum matches what is in the cache and the recipe
342 and class files have not changed, Bitbake is able to use 342 and class files have not changed, Bitbake is able to use
@@ -384,9 +384,9 @@
384 the recipe can be known. 384 the recipe can be known.
385 Each recipe's <filename>PROVIDES</filename> list is created 385 Each recipe's <filename>PROVIDES</filename> list is created
386 implicitly through the recipe's 386 implicitly through the recipe's
387 <link linkend='var-PN'><filename>PN</filename></link> variable 387 <link linkend='var-bb-PN'><filename>PN</filename></link> variable
388 and explicitly through the recipe's 388 and explicitly through the recipe's
389 <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link> 389 <link linkend='var-bb-PROVIDES'><filename>PROVIDES</filename></link>
390 variable, which is optional. 390 variable, which is optional.
391 </para> 391 </para>
392 392
@@ -427,7 +427,7 @@
427 PREFERRED_PROVIDER_virtual/kernel = "linux-yocto" 427 PREFERRED_PROVIDER_virtual/kernel = "linux-yocto"
428 </literallayout> 428 </literallayout>
429 The default 429 The default
430 <link linkend='var-PREFERRED_PROVIDER'><filename>PREFERRED_PROVIDER</filename></link> 430 <link linkend='var-bb-PREFERRED_PROVIDER'><filename>PREFERRED_PROVIDER</filename></link>
431 is the provider with the same name as the target. 431 is the provider with the same name as the target.
432 Bitbake iterates through each target it needs to build and 432 Bitbake iterates through each target it needs to build and
433 resolves them and their dependencies using this process. 433 resolves them and their dependencies using this process.
@@ -439,10 +439,10 @@
439 BitBake defaults to the highest version of a provider. 439 BitBake defaults to the highest version of a provider.
440 Version comparisons are made using the same method as Debian. 440 Version comparisons are made using the same method as Debian.
441 You can use the 441 You can use the
442 <link linkend='var-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></link> 442 <link linkend='var-bb-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></link>
443 variable to specify a particular version. 443 variable to specify a particular version.
444 You can influence the order by using the 444 You can influence the order by using the
445 <link linkend='var-DEFAULT_PREFERENCE'><filename>DEFAULT_PREFERENCE</filename></link> 445 <link linkend='var-bb-DEFAULT_PREFERENCE'><filename>DEFAULT_PREFERENCE</filename></link>
446 variable. 446 variable.
447 </para> 447 </para>
448 448
@@ -464,7 +464,7 @@
464 BitBake defaults to selecting the most recent 464 BitBake defaults to selecting the most recent
465 version, unless otherwise specified. 465 version, unless otherwise specified.
466 If the recipe in question has a 466 If the recipe in question has a
467 <link linkend='var-DEFAULT_PREFERENCE'><filename>DEFAULT_PREFERENCE</filename></link> 467 <link linkend='var-bb-DEFAULT_PREFERENCE'><filename>DEFAULT_PREFERENCE</filename></link>
468 set lower than the other recipes (default is 0), then 468 set lower than the other recipes (default is 0), then
469 it will not be selected. 469 it will not be selected.
470 This allows the person or persons maintaining 470 This allows the person or persons maintaining
@@ -475,9 +475,9 @@
475 475
476 <para> 476 <para>
477 If the first recipe is named <filename>a_1.1.bb</filename>, then the 477 If the first recipe is named <filename>a_1.1.bb</filename>, then the
478 <link linkend='var-PN'><filename>PN</filename></link> variable 478 <link linkend='var-bb-PN'><filename>PN</filename></link> variable
479 will be set to “a”, and the 479 will be set to “a”, and the
480 <link linkend='var-PV'><filename>PV</filename></link> 480 <link linkend='var-bb-PV'><filename>PV</filename></link>
481 variable will be set to 1.1. 481 variable will be set to 1.1.
482 </para> 482 </para>
483 483
@@ -532,11 +532,11 @@
532 <para> 532 <para>
533 Dependencies are defined through several variables. 533 Dependencies are defined through several variables.
534 You can find information about variables BitBake uses in 534 You can find information about variables BitBake uses in
535 the <link linkend='ref-variables-glos'>Variables Glossary</link> 535 the <link linkend='ref-bb-variables-glos'>Variables Glossary</link>
536 near the end of this manual. 536 near the end of this manual.
537 At a basic level, it is sufficient to know that BitBake uses the 537 At a basic level, it is sufficient to know that BitBake uses the
538 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> and 538 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link> and
539 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> variables when 539 <link linkend='var-bb-RDEPENDS'><filename>RDEPENDS</filename></link> variables when
540 calculating dependencies. 540 calculating dependencies.
541 </para> 541 </para>
542 542
@@ -560,7 +560,7 @@
560 560
561 <para> 561 <para>
562 The build now starts with BitBake forking off threads up to the limit set in the 562 The build now starts with BitBake forking off threads up to the limit set in the
563 <link linkend='var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link> 563 <link linkend='var-bb-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link>
564 variable. 564 variable.
565 BitBake continues to fork threads as long as there are tasks ready to run, 565 BitBake continues to fork threads as long as there are tasks ready to run,
566 those tasks have all their dependencies met, and the thread threshold has not been 566 those tasks have all their dependencies met, and the thread threshold has not been
@@ -574,7 +574,7 @@
574 574
575 <para> 575 <para>
576 As each task completes, a timestamp is written to the directory specified by the 576 As each task completes, a timestamp is written to the directory specified by the
577 <link linkend='var-STAMP'><filename>STAMP</filename></link> variable. 577 <link linkend='var-bb-STAMP'><filename>STAMP</filename></link> variable.
578 On subsequent runs, BitBake looks in the build directory within 578 On subsequent runs, BitBake looks in the build directory within
579 <filename>tmp/stamps</filename> and does not rerun 579 <filename>tmp/stamps</filename> and does not rerun
580 tasks that are already completed unless a timestamp is found to be invalid. 580 tasks that are already completed unless a timestamp is found to be invalid.
@@ -618,7 +618,7 @@
618 <para> 618 <para>
619 Tasks can be either a shell task or a Python task. 619 Tasks can be either a shell task or a Python task.
620 For shell tasks, BitBake writes a shell script to 620 For shell tasks, BitBake writes a shell script to
621 <filename>${</filename><link linkend='var-T'><filename>T</filename></link><filename>}/run.do_taskname.pid</filename> 621 <filename>${</filename><link linkend='var-bb-T'><filename>T</filename></link><filename>}/run.do_taskname.pid</filename>
622 and then executes the script. 622 and then executes the script.
623 The generated shell script contains all the exported variables, 623 The generated shell script contains all the exported variables,
624 and the shell functions with all variables expanded. 624 and the shell functions with all variables expanded.
@@ -645,10 +645,10 @@
645 behavior: 645 behavior:
646 <itemizedlist> 646 <itemizedlist>
647 <listitem><para> 647 <listitem><para>
648 <link linkend='var-BB_SCHEDULER'><filename>BB_SCHEDULER</filename></link> 648 <link linkend='var-bb-BB_SCHEDULER'><filename>BB_SCHEDULER</filename></link>
649 </para></listitem> 649 </para></listitem>
650 <listitem><para> 650 <listitem><para>
651 <link linkend='var-BB_SCHEDULERS'><filename>BB_SCHEDULERS</filename></link> 651 <link linkend='var-bb-BB_SCHEDULERS'><filename>BB_SCHEDULERS</filename></link>
652 </para></listitem> 652 </para></listitem>
653 </itemizedlist> 653 </itemizedlist>
654 It is possible to have functions run before and after a task's main 654 It is possible to have functions run before and after a task's main
@@ -684,7 +684,7 @@
684 The simplistic approach for excluding the working directory is to set 684 The simplistic approach for excluding the working directory is to set
685 it to some fixed value and create the checksum for the "run" script. 685 it to some fixed value and create the checksum for the "run" script.
686 BitBake goes one step better and uses the 686 BitBake goes one step better and uses the
687 <link linkend='var-BB_HASHBASE_WHITELIST'><filename>BB_HASHBASE_WHITELIST</filename></link> 687 <link linkend='var-bb-BB_HASHBASE_WHITELIST'><filename>BB_HASHBASE_WHITELIST</filename></link>
688 variable to define a list of variables that should never be included 688 variable to define a list of variables that should never be included
689 when generating the signatures. 689 when generating the signatures.
690 </para> 690 </para>
@@ -795,7 +795,7 @@
795 This results in any metadata change that changes the task hash, automatically 795 This results in any metadata change that changes the task hash, automatically
796 causing the task to be run again. 796 causing the task to be run again.
797 This removes the need to bump 797 This removes the need to bump
798 <link linkend='var-PR'><filename>PR</filename></link> 798 <link linkend='var-bb-PR'><filename>PR</filename></link>
799 values, and changes to metadata automatically ripple across the build. 799 values, and changes to metadata automatically ripple across the build.
800 </para> 800 </para>
801 801
@@ -884,7 +884,7 @@
884 884
885 <para> 885 <para>
886 BitBake first calls the function defined by the 886 BitBake first calls the function defined by the
887 <link linkend='var-BB_HASHCHECK_FUNCTION'><filename>BB_HASHCHECK_FUNCTION</filename></link> 887 <link linkend='var-bb-BB_HASHCHECK_FUNCTION'><filename>BB_HASHCHECK_FUNCTION</filename></link>
888 variable with a list of tasks and corresponding 888 variable with a list of tasks and corresponding
889 hashes it wants to build. 889 hashes it wants to build.
890 This function is designed to be fast and returns a list 890 This function is designed to be fast and returns a list
@@ -908,7 +908,7 @@
908 For example, it is pointless to obtain a compiler if you 908 For example, it is pointless to obtain a compiler if you
909 already have the compiled binary. 909 already have the compiled binary.
910 To handle this, BitBake calls the 910 To handle this, BitBake calls the
911 <link linkend='var-BB_SETSCENE_DEPVALID'><filename>BB_SETSCENE_DEPVALID</filename></link> 911 <link linkend='var-bb-BB_SETSCENE_DEPVALID'><filename>BB_SETSCENE_DEPVALID</filename></link>
912 function for each successful setscene task to know whether or not it needs 912 function for each successful setscene task to know whether or not it needs
913 to obtain the dependencies of that task. 913 to obtain the dependencies of that task.
914 </para> 914 </para>
@@ -916,7 +916,7 @@
916 <para> 916 <para>
917 Finally, after all the setscene tasks have executed, BitBake calls the 917 Finally, after all the setscene tasks have executed, BitBake calls the
918 function listed in 918 function listed in
919 <link linkend='var-BB_SETSCENE_VERIFY_FUNCTION2'><filename>BB_SETSCENE_VERIFY_FUNCTION2</filename></link> 919 <link linkend='var-bb-BB_SETSCENE_VERIFY_FUNCTION2'><filename>BB_SETSCENE_VERIFY_FUNCTION2</filename></link>
920 with the list of tasks BitBake thinks has been "covered". 920 with the list of tasks BitBake thinks has been "covered".
921 The metadata can then ensure that this list is correct and can 921 The metadata can then ensure that this list is correct and can
922 inform BitBake that it wants specific tasks to be run regardless 922 inform BitBake that it wants specific tasks to be run regardless
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
index 92b2c3d1be..3acd7c403e 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
@@ -44,7 +44,7 @@
44 </literallayout> 44 </literallayout>
45 This code sets up an instance of the fetch class. 45 This code sets up an instance of the fetch class.
46 The instance uses a space-separated list of URLs from the 46 The instance uses a space-separated list of URLs from the
47 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> 47 <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>
48 variable and then calls the <filename>download</filename> 48 variable and then calls the <filename>download</filename>
49 method to download the files. 49 method to download the files.
50 </para> 50 </para>
@@ -78,7 +78,7 @@
78 <listitem><para><emphasis>Pre-mirror Sites:</emphasis> 78 <listitem><para><emphasis>Pre-mirror Sites:</emphasis>
79 BitBake first uses pre-mirrors to try and find source files. 79 BitBake first uses pre-mirrors to try and find source files.
80 These locations are defined using the 80 These locations are defined using the
81 <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link> 81 <link linkend='var-bb-PREMIRRORS'><filename>PREMIRRORS</filename></link>
82 variable. 82 variable.
83 </para></listitem> 83 </para></listitem>
84 <listitem><para><emphasis>Source URI:</emphasis> 84 <listitem><para><emphasis>Source URI:</emphasis>
@@ -88,7 +88,7 @@
88 <listitem><para><emphasis>Mirror Sites:</emphasis> 88 <listitem><para><emphasis>Mirror Sites:</emphasis>
89 If fetch failures occur, BitBake next uses mirror locations as 89 If fetch failures occur, BitBake next uses mirror locations as
90 defined by the 90 defined by the
91 <link linkend='var-MIRRORS'><filename>MIRRORS</filename></link> 91 <link linkend='var-bb-MIRRORS'><filename>MIRRORS</filename></link>
92 variable. 92 variable.
93 </para></listitem> 93 </para></listitem>
94 </itemizedlist> 94 </itemizedlist>
@@ -144,7 +144,7 @@
144 Any source files that are not local (i.e. 144 Any source files that are not local (i.e.
145 downloaded from the Internet) are placed into the download 145 downloaded from the Internet) are placed into the download
146 directory, which is specified by the 146 directory, which is specified by the
147 <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> 147 <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link>
148 variable. 148 variable.
149 </para> 149 </para>
150 150
@@ -184,11 +184,11 @@
184 184
185 <para> 185 <para>
186 If 186 If
187 <link linkend='var-BB_STRICT_CHECKSUM'><filename>BB_STRICT_CHECKSUM</filename></link> 187 <link linkend='var-bb-BB_STRICT_CHECKSUM'><filename>BB_STRICT_CHECKSUM</filename></link>
188 is set, any download without a checksum triggers an 188 is set, any download without a checksum triggers an
189 error message. 189 error message.
190 The 190 The
191 <link linkend='var-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></link> 191 <link linkend='var-bb-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></link>
192 variable can be used to make any attempted network access a fatal 192 variable can be used to make any attempted network access a fatal
193 error, which is useful for checking that mirrors are complete 193 error, which is useful for checking that mirrors are complete
194 as well as other things. 194 as well as other things.
@@ -265,11 +265,11 @@
265 The filename you specify within the URL can be 265 The filename you specify within the URL can be
266 either an absolute or relative path to a file. 266 either an absolute or relative path to a file.
267 If the filename is relative, the contents of the 267 If the filename is relative, the contents of the
268 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> 268 <link linkend='var-bb-FILESPATH'><filename>FILESPATH</filename></link>
269 variable is used in the same way 269 variable is used in the same way
270 <filename>PATH</filename> is used to find executables. 270 <filename>PATH</filename> is used to find executables.
271 If the file cannot be found, it is assumed that it is available in 271 If the file cannot be found, it is assumed that it is available in
272 <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> 272 <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link>
273 by the time the <filename>download()</filename> method is called. 273 by the time the <filename>download()</filename> method is called.
274 </para> 274 </para>
275 275
@@ -304,7 +304,7 @@
304 allows the name of the downloaded file to be specified. 304 allows the name of the downloaded file to be specified.
305 Specifying the name of the downloaded file is useful 305 Specifying the name of the downloaded file is useful
306 for avoiding collisions in 306 for avoiding collisions in
307 <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> 307 <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link>
308 when dealing with multiple files that have the same name. 308 when dealing with multiple files that have the same name.
309 </para> 309 </para>
310 310
@@ -355,7 +355,7 @@
355 A special value of "now" causes the checkout to 355 A special value of "now" causes the checkout to
356 be updated on every build. 356 be updated on every build.
357 </para></listitem> 357 </para></listitem>
358 <listitem><para><emphasis><link linkend='var-CVSDIR'><filename>CVSDIR</filename></link>:</emphasis> 358 <listitem><para><emphasis><link linkend='var-bb-CVSDIR'><filename>CVSDIR</filename></link>:</emphasis>
359 Specifies where a temporary checkout is saved. 359 Specifies where a temporary checkout is saved.
360 The location is often <filename>DL_DIR/cvs</filename>. 360 The location is often <filename>DL_DIR/cvs</filename>.
361 </para></listitem> 361 </para></listitem>
@@ -395,7 +395,7 @@
395 <listitem><para><emphasis>"date":</emphasis> 395 <listitem><para><emphasis>"date":</emphasis>
396 Specifies a date. 396 Specifies a date.
397 If no "date" is specified, the 397 If no "date" is specified, the
398 <link linkend='var-SRCDATE'><filename>SRCDATE</filename></link> 398 <link linkend='var-bb-SRCDATE'><filename>SRCDATE</filename></link>
399 of the configuration is used to checkout a specific date. 399 of the configuration is used to checkout a specific date.
400 The special value of "now" causes the checkout to be 400 The special value of "now" causes the checkout to be
401 updated on every build. 401 updated on every build.
@@ -406,7 +406,7 @@
406 to which the module is unpacked. 406 to which the module is unpacked.
407 You are forcing the module into a special 407 You are forcing the module into a special
408 directory relative to 408 directory relative to
409 <link linkend='var-CVSDIR'><filename>CVSDIR</filename></link>. 409 <link linkend='var-bb-CVSDIR'><filename>CVSDIR</filename></link>.
410 </para></listitem> 410 </para></listitem>
411 <listitem><para><emphasis>"rsh"</emphasis> 411 <listitem><para><emphasis>"rsh"</emphasis>
412 Used in conjunction with the "method" parameter. 412 Used in conjunction with the "method" parameter.
@@ -448,7 +448,7 @@
448 <filename>FETCHCMD_svn</filename>, which defaults 448 <filename>FETCHCMD_svn</filename>, which defaults
449 to "svn". 449 to "svn".
450 The fetcher's temporary working directory is set by 450 The fetcher's temporary working directory is set by
451 <link linkend='var-SVNDIR'><filename>SVNDIR</filename></link>, 451 <link linkend='var-bb-SVNDIR'><filename>SVNDIR</filename></link>,
452 which is usually <filename>DL_DIR/svn</filename>. 452 which is usually <filename>DL_DIR/svn</filename>.
453 </para> 453 </para>
454 454
@@ -509,7 +509,7 @@
509 source control system. 509 source control system.
510 The fetcher works by creating a bare clone of the 510 The fetcher works by creating a bare clone of the
511 remote into 511 remote into
512 <link linkend='var-GITDIR'><filename>GITDIR</filename></link>, 512 <link linkend='var-bb-GITDIR'><filename>GITDIR</filename></link>,
513 which is usually <filename>DL_DIR/git2</filename>. 513 which is usually <filename>DL_DIR/git2</filename>.
514 This bare clone is then cloned into the work directory during the 514 This bare clone is then cloned into the work directory during the
515 unpack stage when a specific tree is checked out. 515 unpack stage when a specific tree is checked out.
@@ -612,7 +612,7 @@
612 This fetcher submodule inherits from the 612 This fetcher submodule inherits from the
613 <link linkend='git-fetcher'>Git fetcher</link> and extends 613 <link linkend='git-fetcher'>Git fetcher</link> and extends
614 that fetcher's behavior by fetching a repository's submodules. 614 that fetcher's behavior by fetching a repository's submodules.
615 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> 615 <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>
616 is passed to the Git fetcher as described in the 616 is passed to the Git fetcher as described in the
617 "<link linkend='git-fetcher'>Git Fetcher (<filename>git://</filename>)</link>" 617 "<link linkend='git-fetcher'>Git Fetcher (<filename>git://</filename>)</link>"
618 section. 618 section.
@@ -647,9 +647,9 @@
647 647
648 <para> 648 <para>
649 To use this fetcher, make sure your recipe has proper 649 To use this fetcher, make sure your recipe has proper
650 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>, 650 <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>,
651 <link linkend='var-SRCREV'><filename>SRCREV</filename></link>, and 651 <link linkend='var-bb-SRCREV'><filename>SRCREV</filename></link>, and
652 <link linkend='var-PV'><filename>PV</filename></link> settings. 652 <link linkend='var-bb-PV'><filename>PV</filename></link> settings.
653 Here is an example: 653 Here is an example:
654 <literallayout class='monospaced'> 654 <literallayout class='monospaced'>
655 SRC_URI = "ccrc://cc.example.org/ccrc;vob=/example_vob;module=/example_module" 655 SRC_URI = "ccrc://cc.example.org/ccrc;vob=/example_vob;module=/example_module"
@@ -734,15 +734,15 @@
734 <filename>FETCHCMD_p4</filename>, which defaults 734 <filename>FETCHCMD_p4</filename>, which defaults
735 to "p4". 735 to "p4".
736 The fetcher's temporary working directory is set by 736 The fetcher's temporary working directory is set by
737 <link linkend='var-P4DIR'><filename>P4DIR</filename></link>, 737 <link linkend='var-bb-P4DIR'><filename>P4DIR</filename></link>,
738 which defaults to "DL_DIR/p4". 738 which defaults to "DL_DIR/p4".
739 </para> 739 </para>
740 740
741 <para> 741 <para>
742 To use this fetcher, make sure your recipe has proper 742 To use this fetcher, make sure your recipe has proper
743 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>, 743 <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>,
744 <link linkend='var-SRCREV'><filename>SRCREV</filename></link>, and 744 <link linkend='var-bb-SRCREV'><filename>SRCREV</filename></link>, and
745 <link linkend='var-PV'><filename>PV</filename></link> values. 745 <link linkend='var-bb-PV'><filename>PV</filename></link> values.
746 The p4 executable is able to use the config file defined by your 746 The p4 executable is able to use the config file defined by your
747 system's <filename>P4CONFIG</filename> environment variable in 747 system's <filename>P4CONFIG</filename> environment variable in
748 order to define the Perforce server URL and port, username, and 748 order to define the Perforce server URL and port, username, and
@@ -793,9 +793,9 @@
793 <filename>google-repo</filename> source control system. 793 <filename>google-repo</filename> source control system.
794 The fetcher works by initiating and syncing sources of the 794 The fetcher works by initiating and syncing sources of the
795 repository into 795 repository into
796 <link linkend='var-REPODIR'><filename>REPODIR</filename></link>, 796 <link linkend='var-bb-REPODIR'><filename>REPODIR</filename></link>,
797 which is usually 797 which is usually
798 <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link><filename>/repo</filename>. 798 <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link><filename>/repo</filename>.
799 </para> 799 </para>
800 800
801 <para> 801 <para>
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml
index 9076f0fcd4..39066e4b15 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml
@@ -194,7 +194,7 @@
194 <para> 194 <para>
195 When you run BitBake, it begins looking for metadata files. 195 When you run BitBake, it begins looking for metadata files.
196 The 196 The
197 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> 197 <link linkend='var-bb-BBPATH'><filename>BBPATH</filename></link>
198 variable is what tells BitBake where to look for those files. 198 variable is what tells BitBake where to look for those files.
199 <filename>BBPATH</filename> is not set and you need to set it. 199 <filename>BBPATH</filename> is not set and you need to set it.
200 Without <filename>BBPATH</filename>, Bitbake cannot 200 Without <filename>BBPATH</filename>, Bitbake cannot
@@ -273,14 +273,14 @@
273 some editor to create the <filename>bitbake.conf</filename> 273 some editor to create the <filename>bitbake.conf</filename>
274 so that it contains the following: 274 so that it contains the following:
275 <literallayout class='monospaced'> 275 <literallayout class='monospaced'>
276 <link linkend='var-PN'>PN</link> = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[0] or 'defaultpkgname'}" 276 <link linkend='var-bb-PN'>PN</link> = "${@bb.parse.BBHandler.vars_from_file(d.getVar('FILE', False),d)[0] or 'defaultpkgname'}"
277 </literallayout> 277 </literallayout>
278 <literallayout class='monospaced'> 278 <literallayout class='monospaced'>
279 TMPDIR = "${<link linkend='var-TOPDIR'>TOPDIR</link>}/tmp" 279 TMPDIR = "${<link linkend='var-bb-TOPDIR'>TOPDIR</link>}/tmp"
280 <link linkend='var-CACHE'>CACHE</link> = "${TMPDIR}/cache" 280 <link linkend='var-bb-CACHE'>CACHE</link> = "${TMPDIR}/cache"
281 <link linkend='var-STAMP'>STAMP</link> = "${TMPDIR}/${PN}/stamps" 281 <link linkend='var-bb-STAMP'>STAMP</link> = "${TMPDIR}/${PN}/stamps"
282 <link linkend='var-T'>T</link> = "${TMPDIR}/${PN}/work" 282 <link linkend='var-bb-T'>T</link> = "${TMPDIR}/${PN}/work"
283 <link linkend='var-B'>B</link> = "${TMPDIR}/${PN}" 283 <link linkend='var-bb-B'>B</link> = "${TMPDIR}/${PN}"
284 </literallayout> 284 </literallayout>
285 <note> 285 <note>
286 Without a value for <filename>PN</filename>, the 286 Without a value for <filename>PN</filename>, the
@@ -402,12 +402,12 @@
402 Move to the <filename>conf</filename> directory and create a 402 Move to the <filename>conf</filename> directory and create a
403 <filename>layer.conf</filename> file that has the following: 403 <filename>layer.conf</filename> file that has the following:
404 <literallayout class='monospaced'> 404 <literallayout class='monospaced'>
405 BBPATH .= ":${<link linkend='var-LAYERDIR'>LAYERDIR</link>}" 405 BBPATH .= ":${<link linkend='var-bb-LAYERDIR'>LAYERDIR</link>}"
406 406
407 <link linkend='var-BBFILES'>BBFILES</link> += "${LAYERDIR}/*.bb" 407 <link linkend='var-bb-BBFILES'>BBFILES</link> += "${LAYERDIR}/*.bb"
408 408
409 <link linkend='var-BBFILE_COLLECTIONS'>BBFILE_COLLECTIONS</link> += "mylayer" 409 <link linkend='var-bb-BBFILE_COLLECTIONS'>BBFILE_COLLECTIONS</link> += "mylayer"
410 <link linkend='var-BBFILE_PATTERN'>BBFILE_PATTERN_mylayer</link> := "^${LAYERDIR_RE}/" 410 <link linkend='var-bb-BBFILE_PATTERN'>BBFILE_PATTERN_mylayer</link> := "^${LAYERDIR_RE}/"
411 </literallayout> 411 </literallayout>
412 For information on these variables, click the links 412 For information on these variables, click the links
413 to go to the definitions in the glossary.</para> 413 to go to the definitions in the glossary.</para>
@@ -416,9 +416,9 @@
416 a recipe file named <filename>printhello.bb</filename> that 416 a recipe file named <filename>printhello.bb</filename> that
417 has the following: 417 has the following:
418 <literallayout class='monospaced'> 418 <literallayout class='monospaced'>
419 <link linkend='var-DESCRIPTION'>DESCRIPTION</link> = "Prints Hello World" 419 <link linkend='var-bb-DESCRIPTION'>DESCRIPTION</link> = "Prints Hello World"
420 <link linkend='var-PN'>PN</link> = 'printhello' 420 <link linkend='var-bb-PN'>PN</link> = 'printhello'
421 <link linkend='var-PV'>PV</link> = '1' 421 <link linkend='var-bb-PV'>PV</link> = '1'
422 422
423 python do_build() { 423 python do_build() {
424 bb.plain("********************"); 424 bb.plain("********************");
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
index f7d312a32b..02058a6f62 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
@@ -781,7 +781,7 @@
781 target, you must also enable BitBake to perform multiple 781 target, you must also enable BitBake to perform multiple
782 configuration builds. 782 configuration builds.
783 Enabling is accomplished by setting the 783 Enabling is accomplished by setting the
784 <link linkend='var-BBMULTICONFIG'><filename>BBMULTICONFIG</filename></link> 784 <link linkend='var-bb-BBMULTICONFIG'><filename>BBMULTICONFIG</filename></link>
785 variable in the <filename>local.conf</filename> 785 variable in the <filename>local.conf</filename>
786 configuration file. 786 configuration file.
787 As an example, suppose you had configuration files 787 As an example, suppose you had configuration files
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
index 2490f6e4ba..d00f8a545f 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -595,7 +595,7 @@
595 595
596 <para> 596 <para>
597 BitBake uses 597 BitBake uses
598 <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link> 598 <link linkend='var-bb-OVERRIDES'><filename>OVERRIDES</filename></link>
599 to control what variables are overridden after BitBake 599 to control what variables are overridden after BitBake
600 parses recipes and configuration files. 600 parses recipes and configuration files.
601 This section describes how you can use 601 This section describes how you can use
@@ -705,7 +705,7 @@
705 705
706 <para>Internally, this is implemented by prepending 706 <para>Internally, this is implemented by prepending
707 the task (e.g. "task-compile:") to the value of 707 the task (e.g. "task-compile:") to the value of
708 <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link> 708 <link linkend='var-bb-OVERRIDES'><filename>OVERRIDES</filename></link>
709 for the local datastore of the <filename>do_compile</filename> 709 for the local datastore of the <filename>do_compile</filename>
710 task.</para> 710 task.</para>
711 711
@@ -868,7 +868,7 @@
868 868
869 <para> 869 <para>
870 BitBake uses the 870 BitBake uses the
871 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> 871 <link linkend='var-bb-BBPATH'><filename>BBPATH</filename></link>
872 variable to locate needed include and class files. 872 variable to locate needed include and class files.
873 Additionally, BitBake searches the current directory for 873 Additionally, BitBake searches the current directory for
874 <filename>include</filename> and <filename>require</filename> 874 <filename>include</filename> and <filename>require</filename>
@@ -1086,7 +1086,7 @@
1086 <para> 1086 <para>
1087 When creating a configuration file (<filename>.conf</filename>), 1087 When creating a configuration file (<filename>.conf</filename>),
1088 you can use the 1088 you can use the
1089 <link linkend='var-INHERIT'><filename>INHERIT</filename></link> 1089 <link linkend='var-bb-INHERIT'><filename>INHERIT</filename></link>
1090 configuration directive to inherit a class. 1090 configuration directive to inherit a class.
1091 BitBake only supports this directive when used within 1091 BitBake only supports this directive when used within
1092 a configuration file. 1092 a configuration file.
@@ -1370,7 +1370,7 @@
1370 </para></listitem> 1370 </para></listitem>
1371 <listitem><para> 1371 <listitem><para>
1372 BitBake-style Python functions generate a separate 1372 BitBake-style Python functions generate a separate
1373 <filename>${</filename><link linkend='var-T'><filename>T</filename></link><filename>}/run.</filename><replaceable>function-name</replaceable><filename>.</filename><replaceable>pid</replaceable> 1373 <filename>${</filename><link linkend='var-bb-T'><filename>T</filename></link><filename>}/run.</filename><replaceable>function-name</replaceable><filename>.</filename><replaceable>pid</replaceable>
1374 script that is executed to run the function, and also 1374 script that is executed to run the function, and also
1375 generate a log file in 1375 generate a log file in
1376 <filename>${T}/log.</filename><replaceable>function-name</replaceable><filename>.</filename><replaceable>pid</replaceable> 1376 <filename>${T}/log.</filename><replaceable>function-name</replaceable><filename>.</filename><replaceable>pid</replaceable>
@@ -1773,7 +1773,7 @@
1773 things exported or listed in its whitelist to ensure that the build 1773 things exported or listed in its whitelist to ensure that the build
1774 environment is reproducible and consistent. 1774 environment is reproducible and consistent.
1775 You can prevent this "cleaning" by setting the 1775 You can prevent this "cleaning" by setting the
1776 <link linkend='var-BB_PRESERVE_ENV'><filename>BB_PRESERVE_ENV</filename></link> 1776 <link linkend='var-bb-BB_PRESERVE_ENV'><filename>BB_PRESERVE_ENV</filename></link>
1777 variable. 1777 variable.
1778 </note> 1778 </note>
1779 Consequently, if you do want something to get passed into the 1779 Consequently, if you do want something to get passed into the
@@ -1783,9 +1783,9 @@
1783 Tell BitBake to load what you want from the environment 1783 Tell BitBake to load what you want from the environment
1784 into the datastore. 1784 into the datastore.
1785 You can do so through the 1785 You can do so through the
1786 <link linkend='var-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link> 1786 <link linkend='var-bb-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link>
1787 and 1787 and
1788 <link linkend='var-BB_ENV_EXTRAWHITE'><filename>BB_ENV_EXTRAWHITE</filename></link> 1788 <link linkend='var-bb-BB_ENV_EXTRAWHITE'><filename>BB_ENV_EXTRAWHITE</filename></link>
1789 variables. 1789 variables.
1790 For example, assume you want to prevent the build system from 1790 For example, assume you want to prevent the build system from
1791 accessing your <filename>$HOME/.ccache</filename> 1791 accessing your <filename>$HOME/.ccache</filename>
@@ -1824,7 +1824,7 @@
1824 from the original execution environment. 1824 from the original execution environment.
1825 Bitbake saves a copy of the original environment into 1825 Bitbake saves a copy of the original environment into
1826 a special variable named 1826 a special variable named
1827 <link linkend='var-BB_ORIGENV'><filename>BB_ORIGENV</filename></link>. 1827 <link linkend='var-bb-BB_ORIGENV'><filename>BB_ORIGENV</filename></link>.
1828 </para> 1828 </para>
1829 1829
1830 <para> 1830 <para>
@@ -1883,7 +1883,7 @@
1883 <listitem><para><emphasis><filename>[depends]</filename>:</emphasis> 1883 <listitem><para><emphasis><filename>[depends]</filename>:</emphasis>
1884 Controls inter-task dependencies. 1884 Controls inter-task dependencies.
1885 See the 1885 See the
1886 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 1886 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link>
1887 variable and the 1887 variable and the
1888 "<link linkend='inter-task-dependencies'>Inter-Task Dependencies</link>" 1888 "<link linkend='inter-task-dependencies'>Inter-Task Dependencies</link>"
1889 section for more information. 1889 section for more information.
@@ -1891,7 +1891,7 @@
1891 <listitem><para><emphasis><filename>[deptask]</filename>:</emphasis> 1891 <listitem><para><emphasis><filename>[deptask]</filename>:</emphasis>
1892 Controls task build-time dependencies. 1892 Controls task build-time dependencies.
1893 See the 1893 See the
1894 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 1894 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link>
1895 variable and the 1895 variable and the
1896 "<link linkend='build-dependencies'>Build Dependencies</link>" 1896 "<link linkend='build-dependencies'>Build Dependencies</link>"
1897 section for more information. 1897 section for more information.
@@ -1937,7 +1937,7 @@
1937 of cores but certain tasks need to be rate-limited due to various 1937 of cores but certain tasks need to be rate-limited due to various
1938 kinds of resource constraints (e.g. to avoid network throttling). 1938 kinds of resource constraints (e.g. to avoid network throttling).
1939 <filename>number_threads</filename> works similarly to the 1939 <filename>number_threads</filename> works similarly to the
1940 <link linkend='var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link> 1940 <link linkend='var-bb-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></link>
1941 variable but is task-specific.</para> 1941 variable but is task-specific.</para>
1942 1942
1943 <para>Set the value globally. 1943 <para>Set the value globally.
@@ -1971,9 +1971,9 @@
1971 <listitem><para><emphasis><filename>[rdepends]</filename>:</emphasis> 1971 <listitem><para><emphasis><filename>[rdepends]</filename>:</emphasis>
1972 Controls inter-task runtime dependencies. 1972 Controls inter-task runtime dependencies.
1973 See the 1973 See the
1974 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> 1974 <link linkend='var-bb-RDEPENDS'><filename>RDEPENDS</filename></link>
1975 variable, the 1975 variable, the
1976 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link> 1976 <link linkend='var-bb-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>
1977 variable, and the 1977 variable, and the
1978 "<link linkend='inter-task-dependencies'>Inter-Task Dependencies</link>" 1978 "<link linkend='inter-task-dependencies'>Inter-Task Dependencies</link>"
1979 section for more information. 1979 section for more information.
@@ -1981,9 +1981,9 @@
1981 <listitem><para><emphasis><filename>[rdeptask]</filename>:</emphasis> 1981 <listitem><para><emphasis><filename>[rdeptask]</filename>:</emphasis>
1982 Controls task runtime dependencies. 1982 Controls task runtime dependencies.
1983 See the 1983 See the
1984 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> 1984 <link linkend='var-bb-RDEPENDS'><filename>RDEPENDS</filename></link>
1985 variable, the 1985 variable, the
1986 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link> 1986 <link linkend='var-bb-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>
1987 variable, and the 1987 variable, and the
1988 "<link linkend='runtime-dependencies'>Runtime Dependencies</link>" 1988 "<link linkend='runtime-dependencies'>Runtime Dependencies</link>"
1989 section for more information. 1989 section for more information.
@@ -1996,9 +1996,9 @@
1996 <listitem><para><emphasis><filename>[recrdeptask]</filename>:</emphasis> 1996 <listitem><para><emphasis><filename>[recrdeptask]</filename>:</emphasis>
1997 Controls task recursive runtime dependencies. 1997 Controls task recursive runtime dependencies.
1998 See the 1998 See the
1999 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> 1999 <link linkend='var-bb-RDEPENDS'><filename>RDEPENDS</filename></link>
2000 variable, the 2000 variable, the
2001 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link> 2001 <link linkend='var-bb-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>
2002 variable, and the 2002 variable, and the
2003 "<link linkend='recursive-dependencies'>Recursive Dependencies</link>" 2003 "<link linkend='recursive-dependencies'>Recursive Dependencies</link>"
2004 section for more information. 2004 section for more information.
@@ -2127,7 +2127,7 @@
2127 Any given datastore only has one such event executed 2127 Any given datastore only has one such event executed
2128 against it, however. 2128 against it, however.
2129 If 2129 If
2130 <link linkende='var-BB_INVALIDCONF'><filename>BB_INVALIDCONF</filename></link> 2130 <link linkende='var-bb-BB_INVALIDCONF'><filename>BB_INVALIDCONF</filename></link>
2131 is set in the datastore by the event handler, the 2131 is set in the datastore by the event handler, the
2132 configuration is reparsed and a new event triggered, 2132 configuration is reparsed and a new event triggered,
2133 allowing the metadata to update configuration. 2133 allowing the metadata to update configuration.
@@ -2256,17 +2256,17 @@
2256 from a single recipe file multiple incarnations of that 2256 from a single recipe file multiple incarnations of that
2257 recipe file where all incarnations are buildable. 2257 recipe file where all incarnations are buildable.
2258 These features are enabled through the 2258 These features are enabled through the
2259 <link linkend='var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></link> 2259 <link linkend='var-bb-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></link>
2260 and 2260 and
2261 <link linkend='var-BBVERSIONS'><filename>BBVERSIONS</filename></link> 2261 <link linkend='var-bb-BBVERSIONS'><filename>BBVERSIONS</filename></link>
2262 variables. 2262 variables.
2263 <note> 2263 <note>
2264 The mechanism for this class extension is extremely 2264 The mechanism for this class extension is extremely
2265 specific to the implementation. 2265 specific to the implementation.
2266 Usually, the recipe's 2266 Usually, the recipe's
2267 <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link>, 2267 <link linkend='var-bb-PROVIDES'><filename>PROVIDES</filename></link>,
2268 <link linkend='var-PN'><filename>PN</filename></link>, and 2268 <link linkend='var-bb-PN'><filename>PN</filename></link>, and
2269 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 2269 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link>
2270 variables would need to be modified by the extension class. 2270 variables would need to be modified by the extension class.
2271 For specific examples, see the OE-Core 2271 For specific examples, see the OE-Core
2272 <filename>native</filename>, <filename>nativesdk</filename>, 2272 <filename>native</filename>, <filename>nativesdk</filename>,
@@ -2287,7 +2287,7 @@
2287 project from a single recipe file. 2287 project from a single recipe file.
2288 You can also specify conditional metadata 2288 You can also specify conditional metadata
2289 (using the 2289 (using the
2290 <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link> 2290 <link linkend='var-bb-OVERRIDES'><filename>OVERRIDES</filename></link>
2291 mechanism) for a single version, or an optionally named range of versions. 2291 mechanism) for a single version, or an optionally named range of versions.
2292 Here is an example: 2292 Here is an example:
2293 <literallayout class='monospaced'> 2293 <literallayout class='monospaced'>
@@ -2306,7 +2306,7 @@
2306 into overrides, but it is also made available for the metadata to use 2306 into overrides, but it is also made available for the metadata to use
2307 in the variable that defines the base recipe versions for use in 2307 in the variable that defines the base recipe versions for use in
2308 <filename>file://</filename> search paths 2308 <filename>file://</filename> search paths
2309 (<link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>). 2309 (<link linkend='var-bb-FILESPATH'><filename>FILESPATH</filename></link>).
2310 </para></listitem> 2310 </para></listitem>
2311 </itemizedlist> 2311 </itemizedlist>
2312 </para> 2312 </para>
@@ -2408,7 +2408,7 @@
2408 2408
2409 <para> 2409 <para>
2410 BitBake uses the 2410 BitBake uses the
2411 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 2411 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link>
2412 variable to manage build time dependencies. 2412 variable to manage build time dependencies.
2413 The <filename>[deptask]</filename> varflag for tasks 2413 The <filename>[deptask]</filename> varflag for tasks
2414 signifies the task of each 2414 signifies the task of each
@@ -2429,9 +2429,9 @@
2429 2429
2430 <para> 2430 <para>
2431 BitBake uses the 2431 BitBake uses the
2432 <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>, 2432 <link linkend='var-bb-PACKAGES'><filename>PACKAGES</filename></link>,
2433 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>, and 2433 <link linkend='var-bb-RDEPENDS'><filename>RDEPENDS</filename></link>, and
2434 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link> 2434 <link linkend='var-bb-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>
2435 variables to manage runtime dependencies. 2435 variables to manage runtime dependencies.
2436 </para> 2436 </para>
2437 2437
@@ -2686,7 +2686,7 @@
2686 2686
2687 <para> 2687 <para>
2688 These checksums are stored in 2688 These checksums are stored in
2689 <link linkend='var-STAMP'><filename>STAMP</filename></link>. 2689 <link linkend='var-bb-STAMP'><filename>STAMP</filename></link>.
2690 You can examine the checksums using the following BitBake command: 2690 You can examine the checksums using the following BitBake command:
2691 <literallayout class='monospaced'> 2691 <literallayout class='monospaced'>
2692 $ bitbake-dumpsigs 2692 $ bitbake-dumpsigs
@@ -2708,44 +2708,44 @@
2708 The following list describes related variables: 2708 The following list describes related variables:
2709 <itemizedlist> 2709 <itemizedlist>
2710 <listitem><para> 2710 <listitem><para>
2711 <link linkend='var-BB_HASHCHECK_FUNCTION'><filename>BB_HASHCHECK_FUNCTION</filename></link>: 2711 <link linkend='var-bb-BB_HASHCHECK_FUNCTION'><filename>BB_HASHCHECK_FUNCTION</filename></link>:
2712 Specifies the name of the function to call during 2712 Specifies the name of the function to call during
2713 the "setscene" part of the task's execution in order 2713 the "setscene" part of the task's execution in order
2714 to validate the list of task hashes. 2714 to validate the list of task hashes.
2715 </para></listitem> 2715 </para></listitem>
2716 <listitem><para> 2716 <listitem><para>
2717 <link linkend='var-BB_SETSCENE_DEPVALID'><filename>BB_SETSCENE_DEPVALID</filename></link>: 2717 <link linkend='var-bb-BB_SETSCENE_DEPVALID'><filename>BB_SETSCENE_DEPVALID</filename></link>:
2718 Specifies a function BitBake calls that determines 2718 Specifies a function BitBake calls that determines
2719 whether BitBake requires a setscene dependency to 2719 whether BitBake requires a setscene dependency to
2720 be met. 2720 be met.
2721 </para></listitem> 2721 </para></listitem>
2722 <listitem><para> 2722 <listitem><para>
2723 <link linkend='var-BB_SETSCENE_VERIFY_FUNCTION2'><filename>BB_SETSCENE_VERIFY_FUNCTION2</filename></link>: 2723 <link linkend='var-bb-BB_SETSCENE_VERIFY_FUNCTION2'><filename>BB_SETSCENE_VERIFY_FUNCTION2</filename></link>:
2724 Specifies a function to call that verifies the list of 2724 Specifies a function to call that verifies the list of
2725 planned task execution before the main task execution 2725 planned task execution before the main task execution
2726 happens. 2726 happens.
2727 </para></listitem> 2727 </para></listitem>
2728 <listitem><para> 2728 <listitem><para>
2729 <link linkend='var-BB_STAMP_POLICY'><filename>BB_STAMP_POLICY</filename></link>: 2729 <link linkend='var-bb-BB_STAMP_POLICY'><filename>BB_STAMP_POLICY</filename></link>:
2730 Defines the mode for comparing timestamps of stamp files. 2730 Defines the mode for comparing timestamps of stamp files.
2731 </para></listitem> 2731 </para></listitem>
2732 <listitem><para> 2732 <listitem><para>
2733 <link linkend='var-BB_STAMP_WHITELIST'><filename>BB_STAMP_WHITELIST</filename></link>: 2733 <link linkend='var-bb-BB_STAMP_WHITELIST'><filename>BB_STAMP_WHITELIST</filename></link>:
2734 Lists stamp files that are looked at when the stamp policy 2734 Lists stamp files that are looked at when the stamp policy
2735 is "whitelist". 2735 is "whitelist".
2736 </para></listitem> 2736 </para></listitem>
2737 <listitem><para> 2737 <listitem><para>
2738 <link linkend='var-BB_TASKHASH'><filename>BB_TASKHASH</filename></link>: 2738 <link linkend='var-bb-BB_TASKHASH'><filename>BB_TASKHASH</filename></link>:
2739 Within an executing task, this variable holds the hash 2739 Within an executing task, this variable holds the hash
2740 of the task as returned by the currently enabled 2740 of the task as returned by the currently enabled
2741 signature generator. 2741 signature generator.
2742 </para></listitem> 2742 </para></listitem>
2743 <listitem><para> 2743 <listitem><para>
2744 <link linkend='var-STAMP'><filename>STAMP</filename></link>: 2744 <link linkend='var-bb-STAMP'><filename>STAMP</filename></link>:
2745 The base path to create stamp files. 2745 The base path to create stamp files.
2746 </para></listitem> 2746 </para></listitem>
2747 <listitem><para> 2747 <listitem><para>
2748 <link linkend='var-STAMPCLEAN'><filename>STAMPCLEAN</filename></link>: 2748 <link linkend='var-bb-STAMPCLEAN'><filename>STAMPCLEAN</filename></link>:
2749 Again, the base path to create stamp files but can use wildcards 2749 Again, the base path to create stamp files but can use wildcards
2750 for matching a range of files for clean operations. 2750 for matching a range of files for clean operations.
2751 </para></listitem> 2751 </para></listitem>
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
index a84b2bc994..aca6741c21 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
@@ -3,7 +3,7 @@
3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > 3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
4 4
5<!-- Dummy chapter --> 5<!-- Dummy chapter -->
6<chapter id='ref-variables-glos'> 6<chapter id='ref-bb-variables-glos'>
7 7
8<title>Variables Glossary</title> 8<title>Variables Glossary</title>
9 9
@@ -34,29 +34,29 @@
34 </itemizedlist> 34 </itemizedlist>
35</note> 35</note>
36 36
37<glossary id='ref-variables-glossary'> 37<glossary id='ref-bb-variables-glossary'>
38 38
39 <para> 39 <para>
40 <link linkend='var-ASSUME_PROVIDED'>A</link> 40 <link linkend='var-bb-ASSUME_PROVIDED'>A</link>
41 <link linkend='var-B'>B</link> 41 <link linkend='var-bb-B'>B</link>
42 <link linkend='var-CACHE'>C</link> 42 <link linkend='var-bb-CACHE'>C</link>
43 <link linkend='var-DEFAULT_PREFERENCE'>D</link> 43 <link linkend='var-bb-DEFAULT_PREFERENCE'>D</link>
44 <link linkend='var-EXCLUDE_FROM_WORLD'>E</link> 44 <link linkend='var-bb-EXCLUDE_FROM_WORLD'>E</link>
45 <link linkend='var-FAKEROOT'>F</link> 45 <link linkend='var-bb-FAKEROOT'>F</link>
46 <link linkend='var-GITDIR'>G</link> 46 <link linkend='var-bb-GITDIR'>G</link>
47 <link linkend='var-HGDIR'>H</link> 47 <link linkend='var-bb-HGDIR'>H</link>
48<!-- <link linkend='var-ICECC_DISABLED'>I</link> --> 48 <link linkend='var-bb-INHERIT'>I</link>
49<!-- <link linkend='var-glossary-j'>J</link> --> 49<!-- <link linkend='var-glossary-j'>J</link> -->
50<!-- <link linkend='var-KARCH'>K</link> --> 50<!-- <link linkend='var-KARCH'>K</link> -->
51 <link linkend='var-LAYERDEPENDS'>L</link> 51 <link linkend='var-bb-LAYERDEPENDS'>L</link>
52 <link linkend='var-MIRRORS'>M</link> 52 <link linkend='var-bb-MIRRORS'>M</link>
53<!-- <link linkend='var-glossary-n'>N</link> --> 53<!-- <link linkend='var-glossary-n'>N</link> -->
54 <link linkend='var-OVERRIDES'>O</link> 54 <link linkend='var-bb-OVERRIDES'>O</link>
55 <link linkend='var-P4DIR'>P</link> 55 <link linkend='var-bb-P4DIR'>P</link>
56<!-- <link linkend='var-QMAKE_PROFILES'>Q</link> --> 56<!-- <link linkend='var-QMAKE_PROFILES'>Q</link> -->
57 <link linkend='var-RDEPENDS'>R</link> 57 <link linkend='var-bb-RDEPENDS'>R</link>
58 <link linkend='var-SECTION'>S</link> 58 <link linkend='var-bb-SECTION'>S</link>
59 <link linkend='var-T'>T</link> 59 <link linkend='var-bb-T'>T</link>
60<!-- <link linkend='var-UBOOT_CONFIG'>U</link> --> 60<!-- <link linkend='var-UBOOT_CONFIG'>U</link> -->
61<!-- <link linkend='var-glossary-v'>V</link> --> 61<!-- <link linkend='var-glossary-v'>V</link> -->
62<!-- <link linkend='var-WARN_QA'>W</link> --> 62<!-- <link linkend='var-WARN_QA'>W</link> -->
@@ -65,13 +65,13 @@
65<!-- <link linkend='var-glossary-z'>Z</link>--> 65<!-- <link linkend='var-glossary-z'>Z</link>-->
66 </para> 66 </para>
67 67
68 <glossdiv id='var-glossary-a'><title>A</title> 68 <glossdiv id='var-bb-glossary-a'><title>A</title>
69 69
70 <glossentry id='var-ASSUME_PROVIDED'><glossterm>ASSUME_PROVIDED</glossterm> 70 <glossentry id='var-bb-ASSUME_PROVIDED'><glossterm>ASSUME_PROVIDED</glossterm>
71 <glossdef> 71 <glossdef>
72 <para> 72 <para>
73 Lists recipe names 73 Lists recipe names
74 (<link linkend='var-PN'><filename>PN</filename></link> 74 (<link linkend='var-bb-PN'><filename>PN</filename></link>
75 values) BitBake does not attempt to build. 75 values) BitBake does not attempt to build.
76 Instead, BitBake assumes these recipes have already been 76 Instead, BitBake assumes these recipes have already been
77 built. 77 built.
@@ -91,9 +91,9 @@
91 </glossdiv> 91 </glossdiv>
92 92
93 93
94 <glossdiv id='var-glossary-b'><title>B</title> 94 <glossdiv id='var-bb-glossary-b'><title>B</title>
95 95
96 <glossentry id='var-B'><glossterm>B</glossterm> 96 <glossentry id='var-bb-B'><glossterm>B</glossterm>
97 <glossdef> 97 <glossdef>
98 <para> 98 <para>
99 The directory in which BitBake executes functions 99 The directory in which BitBake executes functions
@@ -102,7 +102,7 @@
102 </glossdef> 102 </glossdef>
103 </glossentry> 103 </glossentry>
104 104
105 <glossentry id='var-BB_ALLOWED_NETWORKS'><glossterm>BB_ALLOWED_NETWORKS</glossterm> 105 <glossentry id='var-bb-BB_ALLOWED_NETWORKS'><glossterm>BB_ALLOWED_NETWORKS</glossterm>
106 <glossdef> 106 <glossdef>
107 <para> 107 <para>
108 Specifies a space-delimited list of hosts that the fetcher 108 Specifies a space-delimited list of hosts that the fetcher
@@ -111,7 +111,7 @@
111 <itemizedlist> 111 <itemizedlist>
112 <listitem><para> 112 <listitem><para>
113 This host list is only used if 113 This host list is only used if
114 <link linkend='var-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></link> 114 <link linkend='var-bb-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></link>
115 is either not set or set to "0". 115 is either not set or set to "0".
116 </para></listitem> 116 </para></listitem>
117 <listitem><para> 117 <listitem><para>
@@ -151,13 +151,13 @@
151 </itemizedlist> 151 </itemizedlist>
152 Using <filename>BB_ALLOWED_NETWORKS</filename> in 152 Using <filename>BB_ALLOWED_NETWORKS</filename> in
153 conjunction with 153 conjunction with
154 <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link> 154 <link linkend='var-bb-PREMIRRORS'><filename>PREMIRRORS</filename></link>
155 is very useful. 155 is very useful.
156 Adding the host you want to use to 156 Adding the host you want to use to
157 <filename>PREMIRRORS</filename> results in the source code 157 <filename>PREMIRRORS</filename> results in the source code
158 being fetched from an allowed location and avoids raising 158 being fetched from an allowed location and avoids raising
159 an error when a host that is not allowed is in a 159 an error when a host that is not allowed is in a
160 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> 160 <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>
161 statement. 161 statement.
162 This is because the fetcher does not attempt to use the 162 This is because the fetcher does not attempt to use the
163 host listed in <filename>SRC_URI</filename> after a 163 host listed in <filename>SRC_URI</filename> after a
@@ -167,7 +167,7 @@
167 </glossdef> 167 </glossdef>
168 </glossentry> 168 </glossentry>
169 169
170 <glossentry id='var-BB_CONSOLELOG'><glossterm>BB_CONSOLELOG</glossterm> 170 <glossentry id='var-bb-BB_CONSOLELOG'><glossterm>BB_CONSOLELOG</glossterm>
171 <glossdef> 171 <glossdef>
172 <para> 172 <para>
173 Specifies the path to a log file into which BitBake's user 173 Specifies the path to a log file into which BitBake's user
@@ -176,7 +176,7 @@
176 </glossdef> 176 </glossdef>
177 </glossentry> 177 </glossentry>
178 178
179 <glossentry id='var-BB_CURRENTTASK'><glossterm>BB_CURRENTTASK</glossterm> 179 <glossentry id='var-bb-BB_CURRENTTASK'><glossterm>BB_CURRENTTASK</glossterm>
180 <glossdef> 180 <glossdef>
181 <para> 181 <para>
182 Contains the name of the currently running task. 182 Contains the name of the currently running task.
@@ -186,7 +186,7 @@
186 </glossdef> 186 </glossdef>
187 </glossentry> 187 </glossentry>
188 188
189 <glossentry id='var-BB_DANGLINGAPPENDS_WARNONLY'><glossterm>BB_DANGLINGAPPENDS_WARNONLY</glossterm> 189 <glossentry id='var-bb-BB_DANGLINGAPPENDS_WARNONLY'><glossterm>BB_DANGLINGAPPENDS_WARNONLY</glossterm>
190 <glossdef> 190 <glossdef>
191 <para> 191 <para>
192 Defines how BitBake handles situations where an append 192 Defines how BitBake handles situations where an append
@@ -208,7 +208,7 @@
208 </glossdef> 208 </glossdef>
209 </glossentry> 209 </glossentry>
210 210
211 <glossentry id='var-BB_DEFAULT_TASK'><glossterm>BB_DEFAULT_TASK</glossterm> 211 <glossentry id='var-bb-BB_DEFAULT_TASK'><glossterm>BB_DEFAULT_TASK</glossterm>
212 <glossdef> 212 <glossdef>
213 <para> 213 <para>
214 The default task to use when none is specified (e.g. 214 The default task to use when none is specified (e.g.
@@ -219,7 +219,7 @@
219 </glossdef> 219 </glossdef>
220 </glossentry> 220 </glossentry>
221 221
222 <glossentry id='var-BB_DISKMON_DIRS'><glossterm>BB_DISKMON_DIRS</glossterm> 222 <glossentry id='var-bb-BB_DISKMON_DIRS'><glossterm>BB_DISKMON_DIRS</glossterm>
223 <glossdef> 223 <glossdef>
224 <para> 224 <para>
225 Monitors disk space and available inodes during the build 225 Monitors disk space and available inodes during the build
@@ -245,7 +245,7 @@
245 build when a threshold is broken. 245 build when a threshold is broken.
246 Subsequent warnings are issued as 246 Subsequent warnings are issued as
247 defined by the 247 defined by the
248 <link linkend='var-BB_DISKMON_WARNINTERVAL'>BB_DISKMON_WARNINTERVAL</link> variable, 248 <link linkend='var-bb-BB_DISKMON_WARNINTERVAL'>BB_DISKMON_WARNINTERVAL</link> variable,
249 which must be defined. 249 which must be defined.
250 250
251 &lt;dir&gt; is: 251 &lt;dir&gt; is:
@@ -275,7 +275,7 @@
275 BB_DISKMON_DIRS = "ABORT,${TMPDIR},,100K" 275 BB_DISKMON_DIRS = "ABORT,${TMPDIR},,100K"
276 </literallayout> 276 </literallayout>
277 The first example works only if you also set 277 The first example works only if you also set
278 the <link linkend='var-BB_DISKMON_WARNINTERVAL'><filename>BB_DISKMON_WARNINTERVAL</filename></link> variable. 278 the <link linkend='var-bb-BB_DISKMON_WARNINTERVAL'><filename>BB_DISKMON_WARNINTERVAL</filename></link> variable.
279 This example causes the build system to immediately 279 This example causes the build system to immediately
280 abort when either the disk space in <filename>${TMPDIR}</filename> drops 280 abort when either the disk space in <filename>${TMPDIR}</filename> drops
281 below 1 Gbyte or the available free inodes drops below 281 below 1 Gbyte or the available free inodes drops below
@@ -309,7 +309,7 @@
309 </glossdef> 309 </glossdef>
310 </glossentry> 310 </glossentry>
311 311
312 <glossentry id='var-BB_DISKMON_WARNINTERVAL'><glossterm>BB_DISKMON_WARNINTERVAL</glossterm> 312 <glossentry id='var-bb-BB_DISKMON_WARNINTERVAL'><glossterm>BB_DISKMON_WARNINTERVAL</glossterm>
313 <glossdef> 313 <glossdef>
314 <para> 314 <para>
315 Defines the disk space and free inode warning intervals. 315 Defines the disk space and free inode warning intervals.
@@ -319,7 +319,7 @@
319 If you are going to use the 319 If you are going to use the
320 <filename>BB_DISKMON_WARNINTERVAL</filename> variable, you must 320 <filename>BB_DISKMON_WARNINTERVAL</filename> variable, you must
321 also use the 321 also use the
322 <link linkend='var-BB_DISKMON_DIRS'><filename>BB_DISKMON_DIRS</filename></link> variable 322 <link linkend='var-bb-BB_DISKMON_DIRS'><filename>BB_DISKMON_DIRS</filename></link> variable
323 and define its action as "WARN". 323 and define its action as "WARN".
324 During the build, subsequent warnings are issued each time 324 During the build, subsequent warnings are issued each time
325 disk space or number of free inodes further reduces by 325 disk space or number of free inodes further reduces by
@@ -374,7 +374,7 @@
374 </glossdef> 374 </glossdef>
375 </glossentry> 375 </glossentry>
376 376
377 <glossentry id='var-BB_ENV_WHITELIST'><glossterm>BB_ENV_WHITELIST</glossterm> 377 <glossentry id='var-bb-BB_ENV_WHITELIST'><glossterm>BB_ENV_WHITELIST</glossterm>
378 <glossdef> 378 <glossdef>
379 <para> 379 <para>
380 Specifies the internal whitelist of variables to allow 380 Specifies the internal whitelist of variables to allow
@@ -382,11 +382,11 @@
382 datastore. 382 datastore.
383 If the value of this variable is not specified 383 If the value of this variable is not specified
384 (which is the default), the following list is used: 384 (which is the default), the following list is used:
385 <link linkend='var-BBPATH'><filename>BBPATH</filename></link>, 385 <link linkend='var-bb-BBPATH'><filename>BBPATH</filename></link>,
386 <link linkend='var-BB_PRESERVE_ENV'><filename>BB_PRESERVE_ENV</filename></link>, 386 <link linkend='var-bb-BB_PRESERVE_ENV'><filename>BB_PRESERVE_ENV</filename></link>,
387 <link linkend='var-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link>, 387 <link linkend='var-bb-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link>,
388 and 388 and
389 <link linkend='var-BB_ENV_EXTRAWHITE'><filename>BB_ENV_EXTRAWHITE</filename></link>. 389 <link linkend='var-bb-BB_ENV_EXTRAWHITE'><filename>BB_ENV_EXTRAWHITE</filename></link>.
390 <note> 390 <note>
391 You must set this variable in the external environment 391 You must set this variable in the external environment
392 in order for it to work. 392 in order for it to work.
@@ -395,7 +395,7 @@
395 </glossdef> 395 </glossdef>
396 </glossentry> 396 </glossentry>
397 397
398 <glossentry id='var-BB_ENV_EXTRAWHITE'><glossterm>BB_ENV_EXTRAWHITE</glossterm> 398 <glossentry id='var-bb-BB_ENV_EXTRAWHITE'><glossterm>BB_ENV_EXTRAWHITE</glossterm>
399 <glossdef> 399 <glossdef>
400 <para> 400 <para>
401 Specifies an additional set of variables to allow through 401 Specifies an additional set of variables to allow through
@@ -403,7 +403,7 @@
403 datastore. 403 datastore.
404 This list of variables are on top of the internal list 404 This list of variables are on top of the internal list
405 set in 405 set in
406 <link linkend='var-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link>. 406 <link linkend='var-bb-BB_ENV_WHITELIST'><filename>BB_ENV_WHITELIST</filename></link>.
407 <note> 407 <note>
408 You must set this variable in the external 408 You must set this variable in the external
409 environment in order for it to work. 409 environment in order for it to work.
@@ -412,22 +412,22 @@
412 </glossdef> 412 </glossdef>
413 </glossentry> 413 </glossentry>
414 414
415 <glossentry id='var-BB_FETCH_PREMIRRORONLY'><glossterm>BB_FETCH_PREMIRRORONLY</glossterm> 415 <glossentry id='var-bb-BB_FETCH_PREMIRRORONLY'><glossterm>BB_FETCH_PREMIRRORONLY</glossterm>
416 <glossdef> 416 <glossdef>
417 <para> 417 <para>
418 When set to "1", causes BitBake's fetcher module to only 418 When set to "1", causes BitBake's fetcher module to only
419 search 419 search
420 <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link> 420 <link linkend='var-bb-PREMIRRORS'><filename>PREMIRRORS</filename></link>
421 for files. 421 for files.
422 BitBake will not search the main 422 BitBake will not search the main
423 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> 423 <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>
424 or 424 or
425 <link linkend='var-MIRRORS'><filename>MIRRORS</filename></link>. 425 <link linkend='var-bb-MIRRORS'><filename>MIRRORS</filename></link>.
426 </para> 426 </para>
427 </glossdef> 427 </glossdef>
428 </glossentry> 428 </glossentry>
429 429
430 <glossentry id='var-BB_FILENAME'><glossterm>BB_FILENAME</glossterm> 430 <glossentry id='var-bb-BB_FILENAME'><glossterm>BB_FILENAME</glossterm>
431 <glossdef> 431 <glossdef>
432 <para> 432 <para>
433 Contains the filename of the recipe that owns the currently 433 Contains the filename of the recipe that owns the currently
@@ -440,12 +440,12 @@
440 </glossdef> 440 </glossdef>
441 </glossentry> 441 </glossentry>
442 442
443 <glossentry id='var-BB_GENERATE_MIRROR_TARBALLS'><glossterm>BB_GENERATE_MIRROR_TARBALLS</glossterm> 443 <glossentry id='var-bb-BB_GENERATE_MIRROR_TARBALLS'><glossterm>BB_GENERATE_MIRROR_TARBALLS</glossterm>
444 <glossdef> 444 <glossdef>
445 <para> 445 <para>
446 Causes tarballs of the Git repositories, including the 446 Causes tarballs of the Git repositories, including the
447 Git metadata, to be placed in the 447 Git metadata, to be placed in the
448 <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> 448 <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link>
449 directory. 449 directory.
450 Anyone wishing to create a source mirror would want to 450 Anyone wishing to create a source mirror would want to
451 enable this variable. 451 enable this variable.
@@ -461,7 +461,7 @@
461 </glossdef> 461 </glossdef>
462 </glossentry> 462 </glossentry>
463 463
464 <glossentry id='var-BB_HASHCONFIG_WHITELIST'><glossterm>BB_HASHCONFIG_WHITELIST</glossterm> 464 <glossentry id='var-bb-BB_HASHCONFIG_WHITELIST'><glossterm>BB_HASHCONFIG_WHITELIST</glossterm>
465 <glossdef> 465 <glossdef>
466 <para> 466 <para>
467 Lists variables that are excluded from base configuration 467 Lists variables that are excluded from base configuration
@@ -485,7 +485,7 @@
485 </glossdef> 485 </glossdef>
486 </glossentry> 486 </glossentry>
487 487
488 <glossentry id='var-BB_HASHBASE_WHITELIST'><glossterm>BB_HASHBASE_WHITELIST</glossterm> 488 <glossentry id='var-bb-BB_HASHBASE_WHITELIST'><glossterm>BB_HASHBASE_WHITELIST</glossterm>
489 <glossdef> 489 <glossdef>
490 <para> 490 <para>
491 Lists variables that are excluded from checksum and 491 Lists variables that are excluded from checksum and
@@ -500,7 +500,7 @@
500 </glossdef> 500 </glossdef>
501 </glossentry> 501 </glossentry>
502 502
503 <glossentry id='var-BB_HASHCHECK_FUNCTION'><glossterm>BB_HASHCHECK_FUNCTION</glossterm> 503 <glossentry id='var-bb-BB_HASHCHECK_FUNCTION'><glossterm>BB_HASHCHECK_FUNCTION</glossterm>
504 <glossdef> 504 <glossdef>
505 <para> 505 <para>
506 Specifies the name of the function to call during the 506 Specifies the name of the function to call during the
@@ -524,7 +524,7 @@
524 </glossdef> 524 </glossdef>
525 </glossentry> 525 </glossentry>
526 526
527 <glossentry id='var-BB_INVALIDCONF'><glossterm>BB_INVALIDCONF</glossterm> 527 <glossentry id='var-bb-BB_INVALIDCONF'><glossterm>BB_INVALIDCONF</glossterm>
528 <glossdef> 528 <glossdef>
529 <para> 529 <para>
530 Used in combination with the 530 Used in combination with the
@@ -539,11 +539,11 @@
539 </glossdef> 539 </glossdef>
540 </glossentry> 540 </glossentry>
541 541
542 <glossentry id='var-BB_LOGFMT'><glossterm>BB_LOGFMT</glossterm> 542 <glossentry id='var-bb-BB_LOGFMT'><glossterm>BB_LOGFMT</glossterm>
543 <glossdef> 543 <glossdef>
544 <para> 544 <para>
545 Specifies the name of the log files saved into 545 Specifies the name of the log files saved into
546 <filename>${</filename><link linkend='var-T'><filename>T</filename></link><filename>}</filename>. 546 <filename>${</filename><link linkend='var-bb-T'><filename>T</filename></link><filename>}</filename>.
547 By default, the <filename>BB_LOGFMT</filename> variable 547 By default, the <filename>BB_LOGFMT</filename> variable
548 is undefined and the log file names get created using the 548 is undefined and the log file names get created using the
549 following form: 549 following form:
@@ -556,7 +556,7 @@
556 </glossdef> 556 </glossdef>
557 </glossentry> 557 </glossentry>
558 558
559 <glossentry id='var-BB_NICE_LEVEL'><glossterm>BB_NICE_LEVEL</glossterm> 559 <glossentry id='var-bb-BB_NICE_LEVEL'><glossterm>BB_NICE_LEVEL</glossterm>
560 <glossdef> 560 <glossdef>
561 <para> 561 <para>
562 Allows BitBake to run at a specific priority 562 Allows BitBake to run at a specific priority
@@ -564,13 +564,13 @@
564 System permissions usually mean that BitBake can reduce its 564 System permissions usually mean that BitBake can reduce its
565 priority but not raise it again. 565 priority but not raise it again.
566 See 566 See
567 <link linkend='var-BB_TASK_NICE_LEVEL'><filename>BB_TASK_NICE_LEVEL</filename></link> 567 <link linkend='var-bb-BB_TASK_NICE_LEVEL'><filename>BB_TASK_NICE_LEVEL</filename></link>
568 for additional information. 568 for additional information.
569 </para> 569 </para>
570 </glossdef> 570 </glossdef>
571 </glossentry> 571 </glossentry>
572 572
573 <glossentry id='var-BB_NO_NETWORK'><glossterm>BB_NO_NETWORK</glossterm> 573 <glossentry id='var-bb-BB_NO_NETWORK'><glossterm>BB_NO_NETWORK</glossterm>
574 <glossdef> 574 <glossdef>
575 <para> 575 <para>
576 Disables network access in the BitBake fetcher modules. 576 Disables network access in the BitBake fetcher modules.
@@ -587,7 +587,7 @@
587 </glossdef> 587 </glossdef>
588 </glossentry> 588 </glossentry>
589 589
590 <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm> 590 <glossentry id='var-bb-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm>
591 <glossdef> 591 <glossdef>
592 <para> 592 <para>
593 The maximum number of tasks BitBake should run in parallel 593 The maximum number of tasks BitBake should run in parallel
@@ -599,7 +599,7 @@
599 </glossdef> 599 </glossdef>
600 </glossentry> 600 </glossentry>
601 601
602 <glossentry id='var-BB_NUMBER_PARSE_THREADS'><glossterm>BB_NUMBER_PARSE_THREADS</glossterm> 602 <glossentry id='var-bb-BB_NUMBER_PARSE_THREADS'><glossterm>BB_NUMBER_PARSE_THREADS</glossterm>
603 <glossdef> 603 <glossdef>
604 <para> 604 <para>
605 Sets the number of threads BitBake uses when parsing. 605 Sets the number of threads BitBake uses when parsing.
@@ -609,7 +609,7 @@
609 </glossdef> 609 </glossdef>
610 </glossentry> 610 </glossentry>
611 611
612 <glossentry id='var-BB_ORIGENV'><glossterm>BB_ORIGENV</glossterm> 612 <glossentry id='var-bb-BB_ORIGENV'><glossterm>BB_ORIGENV</glossterm>
613 <glossdef> 613 <glossdef>
614 <para> 614 <para>
615 Contains a copy of the original external environment in 615 Contains a copy of the original external environment in
@@ -625,7 +625,7 @@
625 </glossdef> 625 </glossdef>
626 </glossentry> 626 </glossentry>
627 627
628 <glossentry id='var-BB_PRESERVE_ENV'><glossterm>BB_PRESERVE_ENV</glossterm> 628 <glossentry id='var-bb-BB_PRESERVE_ENV'><glossterm>BB_PRESERVE_ENV</glossterm>
629 <glossdef> 629 <glossdef>
630 <para> 630 <para>
631 Disables whitelisting and instead allows all variables 631 Disables whitelisting and instead allows all variables
@@ -639,12 +639,12 @@
639 </glossdef> 639 </glossdef>
640 </glossentry> 640 </glossentry>
641 641
642 <glossentry id='var-BB_RUNFMT'><glossterm>BB_RUNFMT</glossterm> 642 <glossentry id='var-bb-BB_RUNFMT'><glossterm>BB_RUNFMT</glossterm>
643 <glossdef> 643 <glossdef>
644 <para> 644 <para>
645 Specifies the name of the executable script files 645 Specifies the name of the executable script files
646 (i.e. run files) saved into 646 (i.e. run files) saved into
647 <filename>${</filename><link linkend='var-T'><filename>T</filename></link><filename>}</filename>. 647 <filename>${</filename><link linkend='var-bb-T'><filename>T</filename></link><filename>}</filename>.
648 By default, the <filename>BB_RUNFMT</filename> variable 648 By default, the <filename>BB_RUNFMT</filename> variable
649 is undefined and the run file names get created using the 649 is undefined and the run file names get created using the
650 following form: 650 following form:
@@ -657,7 +657,7 @@
657 </glossdef> 657 </glossdef>
658 </glossentry> 658 </glossentry>
659 659
660 <glossentry id='var-BB_RUNTASK'><glossterm>BB_RUNTASK</glossterm> 660 <glossentry id='var-bb-BB_RUNTASK'><glossterm>BB_RUNTASK</glossterm>
661 <glossdef> 661 <glossdef>
662 <para> 662 <para>
663 Contains the name of the currently executing task. 663 Contains the name of the currently executing task.
@@ -669,7 +669,7 @@
669 </glossdef> 669 </glossdef>
670 </glossentry> 670 </glossentry>
671 671
672 <glossentry id='var-BB_SCHEDULER'><glossterm>BB_SCHEDULER</glossterm> 672 <glossentry id='var-bb-BB_SCHEDULER'><glossterm>BB_SCHEDULER</glossterm>
673 <glossdef> 673 <glossdef>
674 <para> 674 <para>
675 Selects the name of the scheduler to use for the 675 Selects the name of the scheduler to use for the
@@ -695,7 +695,7 @@
695 </glossdef> 695 </glossdef>
696 </glossentry> 696 </glossentry>
697 697
698 <glossentry id='var-BB_SCHEDULERS'><glossterm>BB_SCHEDULERS</glossterm> 698 <glossentry id='var-bb-BB_SCHEDULERS'><glossterm>BB_SCHEDULERS</glossterm>
699 <glossdef> 699 <glossdef>
700 <para> 700 <para>
701 Defines custom schedulers to import. 701 Defines custom schedulers to import.
@@ -705,13 +705,13 @@
705 705
706 <para> 706 <para>
707 For information how to select a scheduler, see the 707 For information how to select a scheduler, see the
708 <link linkend='var-BB_SCHEDULER'><filename>BB_SCHEDULER</filename></link> 708 <link linkend='var-bb-BB_SCHEDULER'><filename>BB_SCHEDULER</filename></link>
709 variable. 709 variable.
710 </para> 710 </para>
711 </glossdef> 711 </glossdef>
712 </glossentry> 712 </glossentry>
713 713
714 <glossentry id='var-BB_SETSCENE_DEPVALID'><glossterm>BB_SETSCENE_DEPVALID</glossterm> 714 <glossentry id='var-bb-BB_SETSCENE_DEPVALID'><glossterm>BB_SETSCENE_DEPVALID</glossterm>
715 <glossdef> 715 <glossdef>
716 <para> 716 <para>
717 Specifies a function BitBake calls that determines 717 Specifies a function BitBake calls that determines
@@ -731,7 +731,7 @@
731 </glossdef> 731 </glossdef>
732 </glossentry> 732 </glossentry>
733 733
734 <glossentry id='var-BB_SETSCENE_VERIFY_FUNCTION2'><glossterm>BB_SETSCENE_VERIFY_FUNCTION2</glossterm> 734 <glossentry id='var-bb-BB_SETSCENE_VERIFY_FUNCTION2'><glossterm>BB_SETSCENE_VERIFY_FUNCTION2</glossterm>
735 <glossdef> 735 <glossdef>
736 <para> 736 <para>
737 Specifies a function to call that verifies the list of 737 Specifies a function to call that verifies the list of
@@ -752,7 +752,7 @@
752 </glossdef> 752 </glossdef>
753 </glossentry> 753 </glossentry>
754 754
755 <glossentry id='var-BB_SIGNATURE_EXCLUDE_FLAGS'><glossterm>BB_SIGNATURE_EXCLUDE_FLAGS</glossterm> 755 <glossentry id='var-bb-BB_SIGNATURE_EXCLUDE_FLAGS'><glossterm>BB_SIGNATURE_EXCLUDE_FLAGS</glossterm>
756 <glossdef> 756 <glossdef>
757 <para> 757 <para>
758 Lists variable flags (varflags) 758 Lists variable flags (varflags)
@@ -771,7 +771,7 @@
771 </glossdef> 771 </glossdef>
772 </glossentry> 772 </glossentry>
773 773
774 <glossentry id='var-BB_SIGNATURE_HANDLER'><glossterm>BB_SIGNATURE_HANDLER</glossterm> 774 <glossentry id='var-bb-BB_SIGNATURE_HANDLER'><glossterm>BB_SIGNATURE_HANDLER</glossterm>
775 <glossdef> 775 <glossdef>
776 <para> 776 <para>
777 Defines the name of the signature handler BitBake uses. 777 Defines the name of the signature handler BitBake uses.
@@ -790,7 +790,7 @@
790 </glossdef> 790 </glossdef>
791 </glossentry> 791 </glossentry>
792 792
793 <glossentry id='var-BB_SRCREV_POLICY'><glossterm>BB_SRCREV_POLICY</glossterm> 793 <glossentry id='var-bb-BB_SRCREV_POLICY'><glossterm>BB_SRCREV_POLICY</glossterm>
794 <glossdef> 794 <glossdef>
795 <para> 795 <para>
796 Defines the behavior of the fetcher when it interacts with 796 Defines the behavior of the fetcher when it interacts with
@@ -817,7 +817,7 @@
817 </glossdef> 817 </glossdef>
818 </glossentry> 818 </glossentry>
819 819
820 <glossentry id='var-BB_STAMP_POLICY'><glossterm>BB_STAMP_POLICY</glossterm> 820 <glossentry id='var-bb-BB_STAMP_POLICY'><glossterm>BB_STAMP_POLICY</glossterm>
821 <glossdef> 821 <glossdef>
822 <para> 822 <para>
823 Defines the mode used for how timestamps of stamp files 823 Defines the mode used for how timestamps of stamp files
@@ -836,7 +836,7 @@
836 <listitem><para><emphasis>whitelist</emphasis> - 836 <listitem><para><emphasis>whitelist</emphasis> -
837 Identical to "full" mode except timestamp 837 Identical to "full" mode except timestamp
838 comparisons are made for recipes listed in the 838 comparisons are made for recipes listed in the
839 <link linkend='var-BB_STAMP_WHITELIST'><filename>BB_STAMP_WHITELIST</filename></link> 839 <link linkend='var-bb-BB_STAMP_WHITELIST'><filename>BB_STAMP_WHITELIST</filename></link>
840 variable. 840 variable.
841 </para></listitem> 841 </para></listitem>
842 </itemizedlist> 842 </itemizedlist>
@@ -848,19 +848,19 @@
848 </glossdef> 848 </glossdef>
849 </glossentry> 849 </glossentry>
850 850
851 <glossentry id='var-BB_STAMP_WHITELIST'><glossterm>BB_STAMP_WHITELIST</glossterm> 851 <glossentry id='var-bb-BB_STAMP_WHITELIST'><glossterm>BB_STAMP_WHITELIST</glossterm>
852 <glossdef> 852 <glossdef>
853 <para> 853 <para>
854 Lists files whose stamp file timestamps are compared when 854 Lists files whose stamp file timestamps are compared when
855 the stamp policy mode is set to "whitelist". 855 the stamp policy mode is set to "whitelist".
856 For information on stamp policies, see the 856 For information on stamp policies, see the
857 <link linkend='var-BB_STAMP_POLICY'><filename>BB_STAMP_POLICY</filename></link> 857 <link linkend='var-bb-BB_STAMP_POLICY'><filename>BB_STAMP_POLICY</filename></link>
858 variable. 858 variable.
859 </para> 859 </para>
860 </glossdef> 860 </glossdef>
861 </glossentry> 861 </glossentry>
862 862
863 <glossentry id='var-BB_STRICT_CHECKSUM'><glossterm>BB_STRICT_CHECKSUM</glossterm> 863 <glossentry id='var-bb-BB_STRICT_CHECKSUM'><glossterm>BB_STRICT_CHECKSUM</glossterm>
864 <glossdef> 864 <glossdef>
865 <para> 865 <para>
866 Sets a more strict checksum mechanism for non-local URLs. 866 Sets a more strict checksum mechanism for non-local URLs.
@@ -871,7 +871,7 @@
871 </glossdef> 871 </glossdef>
872 </glossentry> 872 </glossentry>
873 873
874 <glossentry id='var-BB_TASK_IONICE_LEVEL'><glossterm>BB_TASK_IONICE_LEVEL</glossterm> 874 <glossentry id='var-bb-BB_TASK_IONICE_LEVEL'><glossterm>BB_TASK_IONICE_LEVEL</glossterm>
875 <glossdef> 875 <glossdef>
876 <para> 876 <para>
877 Allows adjustment of a task's Input/Output priority. 877 Allows adjustment of a task's Input/Output priority.
@@ -882,7 +882,7 @@
882 variable to adjust the I/O priority of these tasks. 882 variable to adjust the I/O priority of these tasks.
883 <note> 883 <note>
884 This variable works similarly to the 884 This variable works similarly to the
885 <link linkend='var-BB_TASK_NICE_LEVEL'><filename>BB_TASK_NICE_LEVEL</filename></link> 885 <link linkend='var-bb-BB_TASK_NICE_LEVEL'><filename>BB_TASK_NICE_LEVEL</filename></link>
886 variable except with a task's I/O priorities. 886 variable except with a task's I/O priorities.
887 </note> 887 </note>
888 </para> 888 </para>
@@ -921,7 +921,7 @@
921 </glossdef> 921 </glossdef>
922 </glossentry> 922 </glossentry>
923 923
924 <glossentry id='var-BB_TASK_NICE_LEVEL'><glossterm>BB_TASK_NICE_LEVEL</glossterm> 924 <glossentry id='var-bb-BB_TASK_NICE_LEVEL'><glossterm>BB_TASK_NICE_LEVEL</glossterm>
925 <glossdef> 925 <glossdef>
926 <para> 926 <para>
927 Allows specific tasks to change their priority 927 Allows specific tasks to change their priority
@@ -940,7 +940,7 @@
940 </glossdef> 940 </glossdef>
941 </glossentry> 941 </glossentry>
942 942
943 <glossentry id='var-BB_TASKHASH'><glossterm>BB_TASKHASH</glossterm> 943 <glossentry id='var-bb-BB_TASKHASH'><glossterm>BB_TASKHASH</glossterm>
944 <glossdef> 944 <glossdef>
945 <para> 945 <para>
946 Within an executing task, this variable holds the hash 946 Within an executing task, this variable holds the hash
@@ -950,7 +950,7 @@
950 </glossdef> 950 </glossdef>
951 </glossentry> 951 </glossentry>
952 952
953 <glossentry id='var-BB_VERBOSE_LOGS'><glossterm>BB_VERBOSE_LOGS</glossterm> 953 <glossentry id='var-bb-BB_VERBOSE_LOGS'><glossterm>BB_VERBOSE_LOGS</glossterm>
954 <glossdef> 954 <glossdef>
955 <para> 955 <para>
956 Controls how verbose BitBake is during builds. 956 Controls how verbose BitBake is during builds.
@@ -960,7 +960,7 @@
960 </glossdef> 960 </glossdef>
961 </glossentry> 961 </glossentry>
962 962
963 <glossentry id='var-BB_WORKERCONTEXT'><glossterm>BB_WORKERCONTEXT</glossterm> 963 <glossentry id='var-bb-BB_WORKERCONTEXT'><glossterm>BB_WORKERCONTEXT</glossterm>
964 <glossdef> 964 <glossdef>
965 <para> 965 <para>
966 Specifies if the current context is executing a task. 966 Specifies if the current context is executing a task.
@@ -973,7 +973,7 @@
973 </glossentry> 973 </glossentry>
974 974
975 975
976 <glossentry id='var-BBCLASSEXTEND'><glossterm>BBCLASSEXTEND</glossterm> 976 <glossentry id='var-bb-BBCLASSEXTEND'><glossterm>BBCLASSEXTEND</glossterm>
977 <glossdef> 977 <glossdef>
978 <para> 978 <para>
979 Allows you to extend a recipe so that it builds variants 979 Allows you to extend a recipe so that it builds variants
@@ -1009,7 +1009,7 @@
1009 <filename>_class-native</filename>. 1009 <filename>_class-native</filename>.
1010 For example, to generate a native version of a recipe, 1010 For example, to generate a native version of a recipe,
1011 a 1011 a
1012 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 1012 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link>
1013 on "foo" is rewritten to a <filename>DEPENDS</filename> 1013 on "foo" is rewritten to a <filename>DEPENDS</filename>
1014 on "foo-native". 1014 on "foo-native".
1015 </para> 1015 </para>
@@ -1028,7 +1028,7 @@
1028 </glossdef> 1028 </glossdef>
1029 </glossentry> 1029 </glossentry>
1030 1030
1031 <glossentry id='var-BBDEBUG'><glossterm>BBDEBUG</glossterm> 1031 <glossentry id='var-bb-BBDEBUG'><glossterm>BBDEBUG</glossterm>
1032 <glossdef> 1032 <glossdef>
1033 <para> 1033 <para>
1034 Sets the BitBake debug output level to a specific value 1034 Sets the BitBake debug output level to a specific value
@@ -1042,7 +1042,7 @@
1042 </glossdef> 1042 </glossdef>
1043 </glossentry> 1043 </glossentry>
1044 1044
1045 <glossentry id='var-BBFILE_COLLECTIONS'><glossterm>BBFILE_COLLECTIONS</glossterm> 1045 <glossentry id='var-bb-BBFILE_COLLECTIONS'><glossterm>BBFILE_COLLECTIONS</glossterm>
1046 <glossdef> 1046 <glossdef>
1047 <para>Lists the names of configured layers. 1047 <para>Lists the names of configured layers.
1048 These names are used to find the other <filename>BBFILE_*</filename> 1048 These names are used to find the other <filename>BBFILE_*</filename>
@@ -1053,10 +1053,10 @@
1053 </glossdef> 1053 </glossdef>
1054 </glossentry> 1054 </glossentry>
1055 1055
1056 <glossentry id='var-BBFILE_PATTERN'><glossterm>BBFILE_PATTERN</glossterm> 1056 <glossentry id='var-bb-BBFILE_PATTERN'><glossterm>BBFILE_PATTERN</glossterm>
1057 <glossdef> 1057 <glossdef>
1058 <para>Variable that expands to match files from 1058 <para>Variable that expands to match files from
1059 <link linkend='var-BBFILES'><filename>BBFILES</filename></link> 1059 <link linkend='var-bb-BBFILES'><filename>BBFILES</filename></link>
1060 in a particular layer. 1060 in a particular layer.
1061 This variable is used in the <filename>conf/layer.conf</filename> file and must 1061 This variable is used in the <filename>conf/layer.conf</filename> file and must
1062 be suffixed with the name of the specific layer (e.g. 1062 be suffixed with the name of the specific layer (e.g.
@@ -1064,7 +1064,7 @@
1064 </glossdef> 1064 </glossdef>
1065 </glossentry> 1065 </glossentry>
1066 1066
1067 <glossentry id='var-BBFILE_PRIORITY'><glossterm>BBFILE_PRIORITY</glossterm> 1067 <glossentry id='var-bb-BBFILE_PRIORITY'><glossterm>BBFILE_PRIORITY</glossterm>
1068 <glossdef> 1068 <glossdef>
1069 <para>Assigns the priority for recipe files in each layer.</para> 1069 <para>Assigns the priority for recipe files in each layer.</para>
1070 <para>This variable is useful in situations where the same recipe appears in 1070 <para>This variable is useful in situations where the same recipe appears in
@@ -1074,7 +1074,7 @@
1074 letting you control the precedence for the multiple layers. 1074 letting you control the precedence for the multiple layers.
1075 The precedence established through this variable stands regardless of a 1075 The precedence established through this variable stands regardless of a
1076 recipe's version 1076 recipe's version
1077 (<link linkend='var-PV'><filename>PV</filename></link> variable). 1077 (<link linkend='var-bb-PV'><filename>PV</filename></link> variable).
1078 For example, a layer that has a recipe with a higher <filename>PV</filename> value but for 1078 For example, a layer that has a recipe with a higher <filename>PV</filename> value but for
1079 which the <filename>BBFILE_PRIORITY</filename> is set to have a lower precedence still has a 1079 which the <filename>BBFILE_PRIORITY</filename> is set to have a lower precedence still has a
1080 lower precedence.</para> 1080 lower precedence.</para>
@@ -1083,7 +1083,7 @@
1083 For example, the value 6 has a higher precedence than the value 5. 1083 For example, the value 6 has a higher precedence than the value 5.
1084 If not specified, the <filename>BBFILE_PRIORITY</filename> variable is set based on layer 1084 If not specified, the <filename>BBFILE_PRIORITY</filename> variable is set based on layer
1085 dependencies (see the 1085 dependencies (see the
1086 <filename><link linkend='var-LAYERDEPENDS'>LAYERDEPENDS</link></filename> variable for 1086 <filename><link linkend='var-bb-LAYERDEPENDS'>LAYERDEPENDS</link></filename> variable for
1087 more information. 1087 more information.
1088 The default priority, if unspecified 1088 The default priority, if unspecified
1089 for a layer with no dependencies, is the lowest defined priority + 1 1089 for a layer with no dependencies, is the lowest defined priority + 1
@@ -1095,7 +1095,7 @@
1095 </glossdef> 1095 </glossdef>
1096 </glossentry> 1096 </glossentry>
1097 1097
1098 <glossentry id='var-BBFILES'><glossterm>BBFILES</glossterm> 1098 <glossentry id='var-bb-BBFILES'><glossterm>BBFILES</glossterm>
1099 <glossdef> 1099 <glossdef>
1100 <para> 1100 <para>
1101 A space-separated list of recipe files BitBake uses to 1101 A space-separated list of recipe files BitBake uses to
@@ -1113,7 +1113,7 @@
1113 </glossdef> 1113 </glossdef>
1114 </glossentry> 1114 </glossentry>
1115 1115
1116 <glossentry id='var-BBINCLUDED'><glossterm>BBINCLUDED</glossterm> 1116 <glossentry id='var-bb-BBINCLUDED'><glossterm>BBINCLUDED</glossterm>
1117 <glossdef> 1117 <glossdef>
1118 <para> 1118 <para>
1119 Contains a space-separated list of all of all files that 1119 Contains a space-separated list of all of all files that
@@ -1123,7 +1123,7 @@
1123 </glossdef> 1123 </glossdef>
1124 </glossentry> 1124 </glossentry>
1125 1125
1126 <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm> 1126 <glossentry id='var-bb-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm>
1127 <glossdef> 1127 <glossdef>
1128 <para> 1128 <para>
1129 If set to a value, enables printing the task log when 1129 If set to a value, enables printing the task log when
@@ -1132,11 +1132,11 @@
1132 </glossdef> 1132 </glossdef>
1133 </glossentry> 1133 </glossentry>
1134 1134
1135 <glossentry id='var-BBINCLUDELOGS_LINES'><glossterm>BBINCLUDELOGS_LINES</glossterm> 1135 <glossentry id='var-bb-BBINCLUDELOGS_LINES'><glossterm>BBINCLUDELOGS_LINES</glossterm>
1136 <glossdef> 1136 <glossdef>
1137 <para> 1137 <para>
1138 If 1138 If
1139 <link linkend='var-BBINCLUDELOGS'><filename>BBINCLUDELOGS</filename></link> 1139 <link linkend='var-bb-BBINCLUDELOGS'><filename>BBINCLUDELOGS</filename></link>
1140 is set, specifies the maximum number of lines from the 1140 is set, specifies the maximum number of lines from the
1141 task log file to print when reporting a failed task. 1141 task log file to print when reporting a failed task.
1142 If you do not set <filename>BBINCLUDELOGS_LINES</filename>, 1142 If you do not set <filename>BBINCLUDELOGS_LINES</filename>,
@@ -1145,7 +1145,7 @@
1145 </glossdef> 1145 </glossdef>
1146 </glossentry> 1146 </glossentry>
1147 1147
1148 <glossentry id='var-BBLAYERS'><glossterm>BBLAYERS</glossterm> 1148 <glossentry id='var-bb-BBLAYERS'><glossterm>BBLAYERS</glossterm>
1149 <glossdef> 1149 <glossdef>
1150 <para>Lists the layers to enable during the build. 1150 <para>Lists the layers to enable during the build.
1151 This variable is defined in the <filename>bblayers.conf</filename> configuration 1151 This variable is defined in the <filename>bblayers.conf</filename> configuration
@@ -1166,7 +1166,7 @@
1166 </glossdef> 1166 </glossdef>
1167 </glossentry> 1167 </glossentry>
1168 1168
1169 <glossentry id='var-BBLAYERS_FETCH_DIR'><glossterm>BBLAYERS_FETCH_DIR</glossterm> 1169 <glossentry id='var-bb-BBLAYERS_FETCH_DIR'><glossterm>BBLAYERS_FETCH_DIR</glossterm>
1170 <glossdef> 1170 <glossdef>
1171 <para> 1171 <para>
1172 Sets the base location where layers are stored. 1172 Sets the base location where layers are stored.
@@ -1178,7 +1178,7 @@
1178 </glossdef> 1178 </glossdef>
1179 </glossentry> 1179 </glossentry>
1180 1180
1181 <glossentry id='var-BBMASK'><glossterm>BBMASK</glossterm> 1181 <glossentry id='var-bb-BBMASK'><glossterm>BBMASK</glossterm>
1182 <glossdef> 1182 <glossdef>
1183 <para> 1183 <para>
1184 Prevents BitBake from processing recipes and recipe 1184 Prevents BitBake from processing recipes and recipe
@@ -1236,7 +1236,7 @@
1236 </glossdef> 1236 </glossdef>
1237 </glossentry> 1237 </glossentry>
1238 1238
1239 <glossentry id='var-BBMULTICONFIG'><glossterm>BBMULTICONFIG</glossterm> 1239 <glossentry id='var-bb-BBMULTICONFIG'><glossterm>BBMULTICONFIG</glossterm>
1240 <info> 1240 <info>
1241 BBMULTICONFIG[doc] = "Enables BitBake to perform multiple configuration builds and lists each separate configuration (multiconfig)." 1241 BBMULTICONFIG[doc] = "Enables BitBake to perform multiple configuration builds and lists each separate configuration (multiconfig)."
1242 </info> 1242 </info>
@@ -1275,7 +1275,7 @@
1275 </glossdef> 1275 </glossdef>
1276 </glossentry> 1276 </glossentry>
1277 1277
1278 <glossentry id='var-BBPATH'><glossterm>BBPATH</glossterm> 1278 <glossentry id='var-bb-BBPATH'><glossterm>BBPATH</glossterm>
1279 <glossdef> 1279 <glossdef>
1280 <para> 1280 <para>
1281 Used by BitBake to locate class 1281 Used by BitBake to locate class
@@ -1302,7 +1302,7 @@
1302 </glossdef> 1302 </glossdef>
1303 </glossentry> 1303 </glossentry>
1304 1304
1305 <glossentry id='var-BBSERVER'><glossterm>BBSERVER</glossterm> 1305 <glossentry id='var-bb-BBSERVER'><glossterm>BBSERVER</glossterm>
1306 <glossdef> 1306 <glossdef>
1307 <para> 1307 <para>
1308 Points to the server that runs memory-resident BitBake. 1308 Points to the server that runs memory-resident BitBake.
@@ -1312,7 +1312,7 @@
1312 </glossdef> 1312 </glossdef>
1313 </glossentry> 1313 </glossentry>
1314 1314
1315 <glossentry id='var-BBTARGETS'><glossterm>BBTARGETS</glossterm> 1315 <glossentry id='var-bb-BBTARGETS'><glossterm>BBTARGETS</glossterm>
1316 <glossdef> 1316 <glossdef>
1317 <para> 1317 <para>
1318 Allows you to use a configuration file to add to the list 1318 Allows you to use a configuration file to add to the list
@@ -1321,14 +1321,14 @@
1321 </glossdef> 1321 </glossdef>
1322 </glossentry> 1322 </glossentry>
1323 1323
1324 <glossentry id='var-BBVERSIONS'><glossterm>BBVERSIONS</glossterm> 1324 <glossentry id='var-bb-BBVERSIONS'><glossterm>BBVERSIONS</glossterm>
1325 <glossdef> 1325 <glossdef>
1326 <para> 1326 <para>
1327 Allows a single recipe to build multiple versions of a 1327 Allows a single recipe to build multiple versions of a
1328 project from a single recipe file. 1328 project from a single recipe file.
1329 You also able to specify conditional metadata 1329 You also able to specify conditional metadata
1330 using the 1330 using the
1331 <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link> 1331 <link linkend='var-bb-OVERRIDES'><filename>OVERRIDES</filename></link>
1332 mechanism for a single version or for an optionally named 1332 mechanism for a single version or for an optionally named
1333 range of versions. 1333 range of versions.
1334 </para> 1334 </para>
@@ -1342,7 +1342,7 @@
1342 </glossdef> 1342 </glossdef>
1343 </glossentry> 1343 </glossentry>
1344 1344
1345 <glossentry id='var-BITBAKE_UI'><glossterm>BITBAKE_UI</glossterm> 1345 <glossentry id='var-bb-BITBAKE_UI'><glossterm>BITBAKE_UI</glossterm>
1346 <glossdef> 1346 <glossdef>
1347 <para> 1347 <para>
1348 Used to specify the UI module to use when running BitBake. 1348 Used to specify the UI module to use when running BitBake.
@@ -1356,7 +1356,7 @@
1356 </glossdef> 1356 </glossdef>
1357 </glossentry> 1357 </glossentry>
1358 1358
1359 <glossentry id='var-BUILDNAME'><glossterm>BUILDNAME</glossterm> 1359 <glossentry id='var-bb-BUILDNAME'><glossterm>BUILDNAME</glossterm>
1360 <glossdef> 1360 <glossdef>
1361 <para> 1361 <para>
1362 A name assigned to the build. 1362 A name assigned to the build.
@@ -1366,7 +1366,7 @@
1366 </glossdef> 1366 </glossdef>
1367 </glossentry> 1367 </glossentry>
1368 1368
1369 <glossentry id='var-BZRDIR'><glossterm>BZRDIR</glossterm> 1369 <glossentry id='var-bb-BZRDIR'><glossterm>BZRDIR</glossterm>
1370 <glossdef> 1370 <glossdef>
1371 <para> 1371 <para>
1372 The directory in which files checked out of a Bazaar 1372 The directory in which files checked out of a Bazaar
@@ -1377,9 +1377,9 @@
1377 1377
1378 </glossdiv> 1378 </glossdiv>
1379 1379
1380 <glossdiv id='var-glossary-c'><title>C</title> 1380 <glossdiv id='var-bb-glossary-c'><title>C</title>
1381 1381
1382 <glossentry id='var-CACHE'><glossterm>CACHE</glossterm> 1382 <glossentry id='var-bb-CACHE'><glossterm>CACHE</glossterm>
1383 <glossdef> 1383 <glossdef>
1384 <para> 1384 <para>
1385 Specifies the directory BitBake uses to store a cache 1385 Specifies the directory BitBake uses to store a cache
@@ -1389,7 +1389,7 @@
1389 </glossdef> 1389 </glossdef>
1390 </glossentry> 1390 </glossentry>
1391 1391
1392 <glossentry id='var-CVSDIR'><glossterm>CVSDIR</glossterm> 1392 <glossentry id='var-bb-CVSDIR'><glossterm>CVSDIR</glossterm>
1393 <glossdef> 1393 <glossdef>
1394 <para> 1394 <para>
1395 The directory in which files checked out under the 1395 The directory in which files checked out under the
@@ -1400,9 +1400,9 @@
1400 1400
1401 </glossdiv> 1401 </glossdiv>
1402 1402
1403 <glossdiv id='var-glossary-d'><title>D</title> 1403 <glossdiv id='var-bb-glossary-d'><title>D</title>
1404 1404
1405 <glossentry id='var-DEFAULT_PREFERENCE'><glossterm>DEFAULT_PREFERENCE</glossterm> 1405 <glossentry id='var-bb-DEFAULT_PREFERENCE'><glossterm>DEFAULT_PREFERENCE</glossterm>
1406 <glossdef> 1406 <glossdef>
1407 <para> 1407 <para>
1408 Specifies a weak bias for recipe selection priority. 1408 Specifies a weak bias for recipe selection priority.
@@ -1413,20 +1413,20 @@
1413 piece of software. 1413 piece of software.
1414 Using the variable in this way causes the stable version 1414 Using the variable in this way causes the stable version
1415 of the recipe to build by default in the absence of 1415 of the recipe to build by default in the absence of
1416 <filename><link linkend='var-PREFERRED_VERSION'>PREFERRED_VERSION</link></filename> 1416 <filename><link linkend='var-bb-PREFERRED_VERSION'>PREFERRED_VERSION</link></filename>
1417 being used to build the development version. 1417 being used to build the development version.
1418 </para> 1418 </para>
1419 <note> 1419 <note>
1420 The bias provided by <filename>DEFAULT_PREFERENCE</filename> 1420 The bias provided by <filename>DEFAULT_PREFERENCE</filename>
1421 is weak and is overridden by 1421 is weak and is overridden by
1422 <filename><link linkend='var-BBFILE_PRIORITY'>BBFILE_PRIORITY</link></filename> 1422 <filename><link linkend='var-bb-BBFILE_PRIORITY'>BBFILE_PRIORITY</link></filename>
1423 if that variable is different between two layers 1423 if that variable is different between two layers
1424 that contain different versions of the same recipe. 1424 that contain different versions of the same recipe.
1425 </note> 1425 </note>
1426 </glossdef> 1426 </glossdef>
1427 </glossentry> 1427 </glossentry>
1428 1428
1429 <glossentry id='var-DEPENDS'><glossterm>DEPENDS</glossterm> 1429 <glossentry id='var-bb-DEPENDS'><glossterm>DEPENDS</glossterm>
1430 <glossdef> 1430 <glossdef>
1431 <para> 1431 <para>
1432 Lists a recipe's build-time dependencies 1432 Lists a recipe's build-time dependencies
@@ -1451,13 +1451,13 @@
1451 1451
1452 <para> 1452 <para>
1453 For information on runtime dependencies, see the 1453 For information on runtime dependencies, see the
1454 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> 1454 <link linkend='var-bb-RDEPENDS'><filename>RDEPENDS</filename></link>
1455 variable. 1455 variable.
1456 </para> 1456 </para>
1457 </glossdef> 1457 </glossdef>
1458 </glossentry> 1458 </glossentry>
1459 1459
1460 <glossentry id='var-DESCRIPTION'><glossterm>DESCRIPTION</glossterm> 1460 <glossentry id='var-bb-DESCRIPTION'><glossterm>DESCRIPTION</glossterm>
1461 <glossdef> 1461 <glossdef>
1462 <para> 1462 <para>
1463 A long description for the recipe. 1463 A long description for the recipe.
@@ -1465,7 +1465,7 @@
1465 </glossdef> 1465 </glossdef>
1466 </glossentry> 1466 </glossentry>
1467 1467
1468 <glossentry id='var-DL_DIR'><glossterm>DL_DIR</glossterm> 1468 <glossentry id='var-bb-DL_DIR'><glossterm>DL_DIR</glossterm>
1469 <glossdef> 1469 <glossdef>
1470 <para> 1470 <para>
1471 The central download directory used by the build process to 1471 The central download directory used by the build process to
@@ -1474,7 +1474,7 @@
1474 suitable for mirroring for everything except Git 1474 suitable for mirroring for everything except Git
1475 repositories. 1475 repositories.
1476 If you want tarballs of Git repositories, use the 1476 If you want tarballs of Git repositories, use the
1477 <link linkend='var-BB_GENERATE_MIRROR_TARBALLS'><filename>BB_GENERATE_MIRROR_TARBALLS</filename></link> 1477 <link linkend='var-bb-BB_GENERATE_MIRROR_TARBALLS'><filename>BB_GENERATE_MIRROR_TARBALLS</filename></link>
1478 variable. 1478 variable.
1479 </para> 1479 </para>
1480 </glossdef> 1480 </glossdef>
@@ -1482,9 +1482,9 @@
1482 </glossentry> 1482 </glossentry>
1483 </glossdiv> 1483 </glossdiv>
1484 1484
1485 <glossdiv id='var-glossary-e'><title>E</title> 1485 <glossdiv id='var-bb-glossary-e'><title>E</title>
1486 1486
1487 <glossentry id='var-EXCLUDE_FROM_WORLD'><glossterm>EXCLUDE_FROM_WORLD</glossterm> 1487 <glossentry id='var-bb-EXCLUDE_FROM_WORLD'><glossterm>EXCLUDE_FROM_WORLD</glossterm>
1488 <glossdef> 1488 <glossdef>
1489 <para> 1489 <para>
1490 Directs BitBake to exclude a recipe from world builds (i.e. 1490 Directs BitBake to exclude a recipe from world builds (i.e.
@@ -1512,9 +1512,9 @@
1512 1512
1513 </glossdiv> 1513 </glossdiv>
1514 1514
1515 <glossdiv id='var-glossary-f'><title>F</title> 1515 <glossdiv id='var-bb-glossary-f'><title>F</title>
1516 1516
1517 <glossentry id='var-FAKEROOT'><glossterm>FAKEROOT</glossterm> 1517 <glossentry id='var-bb-FAKEROOT'><glossterm>FAKEROOT</glossterm>
1518 <glossdef> 1518 <glossdef>
1519 <para> 1519 <para>
1520 Contains the command to use when running a shell script 1520 Contains the command to use when running a shell script
@@ -1527,19 +1527,19 @@
1527 </glossdef> 1527 </glossdef>
1528 </glossentry> 1528 </glossentry>
1529 1529
1530 <glossentry id='var-FAKEROOTBASEENV'><glossterm>FAKEROOTBASEENV</glossterm> 1530 <glossentry id='var-bb-FAKEROOTBASEENV'><glossterm>FAKEROOTBASEENV</glossterm>
1531 <glossdef> 1531 <glossdef>
1532 <para> 1532 <para>
1533 Lists environment variables to set when executing 1533 Lists environment variables to set when executing
1534 the command defined by 1534 the command defined by
1535 <link linkend='var-FAKEROOTCMD'><filename>FAKEROOTCMD</filename></link> 1535 <link linkend='var-bb-FAKEROOTCMD'><filename>FAKEROOTCMD</filename></link>
1536 that starts the bitbake-worker process 1536 that starts the bitbake-worker process
1537 in the fakeroot environment. 1537 in the fakeroot environment.
1538 </para> 1538 </para>
1539 </glossdef> 1539 </glossdef>
1540 </glossentry> 1540 </glossentry>
1541 1541
1542 <glossentry id='var-FAKEROOTCMD'><glossterm>FAKEROOTCMD</glossterm> 1542 <glossentry id='var-bb-FAKEROOTCMD'><glossterm>FAKEROOTCMD</glossterm>
1543 <glossdef> 1543 <glossdef>
1544 <para> 1544 <para>
1545 Contains the command that starts the bitbake-worker 1545 Contains the command that starts the bitbake-worker
@@ -1548,7 +1548,7 @@
1548 </glossdef> 1548 </glossdef>
1549 </glossentry> 1549 </glossentry>
1550 1550
1551 <glossentry id='var-FAKEROOTDIRS'><glossterm>FAKEROOTDIRS</glossterm> 1551 <glossentry id='var-bb-FAKEROOTDIRS'><glossterm>FAKEROOTDIRS</glossterm>
1552 <glossdef> 1552 <glossdef>
1553 <para> 1553 <para>
1554 Lists directories to create before running a task in 1554 Lists directories to create before running a task in
@@ -1557,33 +1557,33 @@
1557 </glossdef> 1557 </glossdef>
1558 </glossentry> 1558 </glossentry>
1559 1559
1560 <glossentry id='var-FAKEROOTENV'><glossterm>FAKEROOTENV</glossterm> 1560 <glossentry id='var-bb-FAKEROOTENV'><glossterm>FAKEROOTENV</glossterm>
1561 <glossdef> 1561 <glossdef>
1562 <para> 1562 <para>
1563 Lists environment variables to set when running a task 1563 Lists environment variables to set when running a task
1564 in the fakeroot environment. 1564 in the fakeroot environment.
1565 For additional information on environment variables and 1565 For additional information on environment variables and
1566 the fakeroot environment, see the 1566 the fakeroot environment, see the
1567 <link linkend='var-FAKEROOTBASEENV'><filename>FAKEROOTBASEENV</filename></link> 1567 <link linkend='var-bb-FAKEROOTBASEENV'><filename>FAKEROOTBASEENV</filename></link>
1568 variable. 1568 variable.
1569 </para> 1569 </para>
1570 </glossdef> 1570 </glossdef>
1571 </glossentry> 1571 </glossentry>
1572 1572
1573 <glossentry id='var-FAKEROOTNOENV'><glossterm>FAKEROOTNOENV</glossterm> 1573 <glossentry id='var-bb-FAKEROOTNOENV'><glossterm>FAKEROOTNOENV</glossterm>
1574 <glossdef> 1574 <glossdef>
1575 <para> 1575 <para>
1576 Lists environment variables to set when running a task 1576 Lists environment variables to set when running a task
1577 that is not in the fakeroot environment. 1577 that is not in the fakeroot environment.
1578 For additional information on environment variables and 1578 For additional information on environment variables and
1579 the fakeroot environment, see the 1579 the fakeroot environment, see the
1580 <link linkend='var-FAKEROOTENV'><filename>FAKEROOTENV</filename></link> 1580 <link linkend='var-bb-FAKEROOTENV'><filename>FAKEROOTENV</filename></link>
1581 variable. 1581 variable.
1582 </para> 1582 </para>
1583 </glossdef> 1583 </glossdef>
1584 </glossentry> 1584 </glossentry>
1585 1585
1586 <glossentry id='var-FETCHCMD'><glossterm>FETCHCMD</glossterm> 1586 <glossentry id='var-bb-FETCHCMD'><glossterm>FETCHCMD</glossterm>
1587 <glossdef> 1587 <glossdef>
1588 <para> 1588 <para>
1589 Defines the command the BitBake fetcher module 1589 Defines the command the BitBake fetcher module
@@ -1595,7 +1595,7 @@
1595 </glossdef> 1595 </glossdef>
1596 </glossentry> 1596 </glossentry>
1597 1597
1598 <glossentry id='var-FILE'><glossterm>FILE</glossterm> 1598 <glossentry id='var-bb-FILE'><glossterm>FILE</glossterm>
1599 <glossdef> 1599 <glossdef>
1600 <para> 1600 <para>
1601 Points at the current file. 1601 Points at the current file.
@@ -1607,7 +1607,7 @@
1607 </glossdef> 1607 </glossdef>
1608 </glossentry> 1608 </glossentry>
1609 1609
1610 <glossentry id='var-FILESPATH'><glossterm>FILESPATH</glossterm> 1610 <glossentry id='var-bb-FILESPATH'><glossterm>FILESPATH</glossterm>
1611 <glossdef> 1611 <glossdef>
1612 <para> 1612 <para>
1613 Specifies directories BitBake uses when searching for 1613 Specifies directories BitBake uses when searching for
@@ -1625,9 +1625,9 @@
1625 </glossdiv> 1625 </glossdiv>
1626 1626
1627 1627
1628 <glossdiv id='var-glossary-g'><title>G</title> 1628 <glossdiv id='var-bb-glossary-g'><title>G</title>
1629 1629
1630 <glossentry id='var-GITDIR'><glossterm>GITDIR</glossterm> 1630 <glossentry id='var-bb-GITDIR'><glossterm>GITDIR</glossterm>
1631 <glossdef> 1631 <glossdef>
1632 <para> 1632 <para>
1633 The directory in which a local copy of a Git repository 1633 The directory in which a local copy of a Git repository
@@ -1639,9 +1639,9 @@
1639 </glossdiv> 1639 </glossdiv>
1640 1640
1641 1641
1642 <glossdiv id='var-glossary-h'><title>H</title> 1642 <glossdiv id='var-bb-glossary-h'><title>H</title>
1643 1643
1644 <glossentry id='var-HGDIR'><glossterm>HGDIR</glossterm> 1644 <glossentry id='var-bb-HGDIR'><glossterm>HGDIR</glossterm>
1645 <glossdef> 1645 <glossdef>
1646 <para> 1646 <para>
1647 The directory in which files checked out of a Mercurial 1647 The directory in which files checked out of a Mercurial
@@ -1650,7 +1650,7 @@
1650 </glossdef> 1650 </glossdef>
1651 </glossentry> 1651 </glossentry>
1652 1652
1653 <glossentry id='var-HOMEPAGE'><glossterm>HOMEPAGE</glossterm> 1653 <glossentry id='var-bb-HOMEPAGE'><glossterm>HOMEPAGE</glossterm>
1654 <glossdef> 1654 <glossdef>
1655 <para>Website where more information about the software the recipe is building 1655 <para>Website where more information about the software the recipe is building
1656 can be found.</para> 1656 can be found.</para>
@@ -1659,9 +1659,9 @@
1659 1659
1660 </glossdiv> 1660 </glossdiv>
1661 1661
1662 <glossdiv id='var-glossary-i'><title>I</title> 1662 <glossdiv id='var-bb-glossary-i'><title>I</title>
1663 1663
1664 <glossentry id='var-INHERIT'><glossterm>INHERIT</glossterm> 1664 <glossentry id='var-bb-INHERIT'><glossterm>INHERIT</glossterm>
1665 <glossdef> 1665 <glossdef>
1666 <para> 1666 <para>
1667 Causes the named class or classes to be inherited globally. 1667 Causes the named class or classes to be inherited globally.
@@ -1691,15 +1691,15 @@
1691 </glossdiv> 1691 </glossdiv>
1692--> 1692-->
1693 1693
1694 <glossdiv id='var-glossary-l'><title>L</title> 1694 <glossdiv id='var-bb-glossary-l'><title>L</title>
1695 1695
1696 <glossentry id='var-LAYERDEPENDS'><glossterm>LAYERDEPENDS</glossterm> 1696 <glossentry id='var-bb-LAYERDEPENDS'><glossterm>LAYERDEPENDS</glossterm>
1697 <glossdef> 1697 <glossdef>
1698 <para>Lists the layers, separated by spaces, upon which this recipe depends. 1698 <para>Lists the layers, separated by spaces, upon which this recipe depends.
1699 Optionally, you can specify a specific layer version for a dependency 1699 Optionally, you can specify a specific layer version for a dependency
1700 by adding it to the end of the layer name with a colon, (e.g. "anotherlayer:3" 1700 by adding it to the end of the layer name with a colon, (e.g. "anotherlayer:3"
1701 to be compared against 1701 to be compared against
1702 <link linkend='var-LAYERVERSION'><filename>LAYERVERSION</filename></link><filename>_anotherlayer</filename> 1702 <link linkend='var-bb-LAYERVERSION'><filename>LAYERVERSION</filename></link><filename>_anotherlayer</filename>
1703 in this case). 1703 in this case).
1704 BitBake produces an error if any dependency is missing or 1704 BitBake produces an error if any dependency is missing or
1705 the version numbers do not match exactly (if specified).</para> 1705 the version numbers do not match exactly (if specified).</para>
@@ -1710,7 +1710,7 @@
1710 </glossdef> 1710 </glossdef>
1711 </glossentry> 1711 </glossentry>
1712 1712
1713 <glossentry id='var-LAYERDIR'><glossterm>LAYERDIR</glossterm> 1713 <glossentry id='var-bb-LAYERDIR'><glossterm>LAYERDIR</glossterm>
1714 <glossdef> 1714 <glossdef>
1715 <para>When used inside the <filename>layer.conf</filename> configuration 1715 <para>When used inside the <filename>layer.conf</filename> configuration
1716 file, this variable provides the path of the current layer. 1716 file, this variable provides the path of the current layer.
@@ -1719,22 +1719,22 @@
1719 </glossdef> 1719 </glossdef>
1720 </glossentry> 1720 </glossentry>
1721 1721
1722 <glossentry id='var-LAYERDIR_RE'><glossterm>LAYERDIR_RE</glossterm> 1722 <glossentry id='var-bb-LAYERDIR_RE'><glossterm>LAYERDIR_RE</glossterm>
1723 <glossdef> 1723 <glossdef>
1724 <para>When used inside the <filename>layer.conf</filename> configuration 1724 <para>When used inside the <filename>layer.conf</filename> configuration
1725 file, this variable provides the path of the current layer, 1725 file, this variable provides the path of the current layer,
1726 escaped for use in a regular expression 1726 escaped for use in a regular expression
1727 (<link linkend='var-BBFILE_PATTERN'><filename>BBFILE_PATTERN</filename></link>). 1727 (<link linkend='var-bb-BBFILE_PATTERN'><filename>BBFILE_PATTERN</filename></link>).
1728 This variable is not available outside of <filename>layer.conf</filename> 1728 This variable is not available outside of <filename>layer.conf</filename>
1729 and references are expanded immediately when parsing of the file completes.</para> 1729 and references are expanded immediately when parsing of the file completes.</para>
1730 </glossdef> 1730 </glossdef>
1731 </glossentry> 1731 </glossentry>
1732 1732
1733 <glossentry id='var-LAYERVERSION'><glossterm>LAYERVERSION</glossterm> 1733 <glossentry id='var-bb-LAYERVERSION'><glossterm>LAYERVERSION</glossterm>
1734 <glossdef> 1734 <glossdef>
1735 <para>Optionally specifies the version of a layer as a single number. 1735 <para>Optionally specifies the version of a layer as a single number.
1736 You can use this variable within 1736 You can use this variable within
1737 <link linkend='var-LAYERDEPENDS'><filename>LAYERDEPENDS</filename></link> 1737 <link linkend='var-bb-LAYERDEPENDS'><filename>LAYERDEPENDS</filename></link>
1738 for another layer in order to depend on a specific version 1738 for another layer in order to depend on a specific version
1739 of the layer.</para> 1739 of the layer.</para>
1740 <para> 1740 <para>
@@ -1744,7 +1744,7 @@
1744 </glossdef> 1744 </glossdef>
1745 </glossentry> 1745 </glossentry>
1746 1746
1747 <glossentry id='var-LICENSE'><glossterm>LICENSE</glossterm> 1747 <glossentry id='var-bb-LICENSE'><glossterm>LICENSE</glossterm>
1748 <glossdef> 1748 <glossdef>
1749 <para> 1749 <para>
1750 The list of source licenses for the recipe. 1750 The list of source licenses for the recipe.
@@ -1754,9 +1754,9 @@
1754 1754
1755 </glossdiv> 1755 </glossdiv>
1756 1756
1757 <glossdiv id='var-glossary-m'><title>M</title> 1757 <glossdiv id='var-bb-glossary-m'><title>M</title>
1758 1758
1759 <glossentry id='var-MIRRORS'><glossterm>MIRRORS</glossterm> 1759 <glossentry id='var-bb-MIRRORS'><glossterm>MIRRORS</glossterm>
1760 <glossdef> 1760 <glossdef>
1761 <para> 1761 <para>
1762 Specifies additional paths from which BitBake gets source code. 1762 Specifies additional paths from which BitBake gets source code.
@@ -1764,14 +1764,14 @@
1764 tries the local download directory. 1764 tries the local download directory.
1765 If that location fails, the build system tries locations 1765 If that location fails, the build system tries locations
1766 defined by 1766 defined by
1767 <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link>, 1767 <link linkend='var-bb-PREMIRRORS'><filename>PREMIRRORS</filename></link>,
1768 the upstream source, and then locations specified by 1768 the upstream source, and then locations specified by
1769 <filename>MIRRORS</filename> in that order. 1769 <filename>MIRRORS</filename> in that order.
1770 </para> 1770 </para>
1771 </glossdef> 1771 </glossdef>
1772 </glossentry> 1772 </glossentry>
1773 1773
1774 <glossentry id='var-MULTI_PROVIDER_WHITELIST'><glossterm>MULTI_PROVIDER_WHITELIST</glossterm> 1774 <glossentry id='var-bb-MULTI_PROVIDER_WHITELIST'><glossterm>MULTI_PROVIDER_WHITELIST</glossterm>
1775 <glossdef> 1775 <glossdef>
1776 <para> 1776 <para>
1777 Allows you to suppress BitBake warnings caused when 1777 Allows you to suppress BitBake warnings caused when
@@ -1804,9 +1804,9 @@
1804 </glossdiv> 1804 </glossdiv>
1805--> 1805-->
1806 1806
1807 <glossdiv id='var-glossary-o'><title>O</title> 1807 <glossdiv id='var-bb-glossary-o'><title>O</title>
1808 1808
1809 <glossentry id='var-OVERRIDES'><glossterm>OVERRIDES</glossterm> 1809 <glossentry id='var-bb-OVERRIDES'><glossterm>OVERRIDES</glossterm>
1810 <glossdef> 1810 <glossdef>
1811 <para> 1811 <para>
1812 BitBake uses <filename>OVERRIDES</filename> to control 1812 BitBake uses <filename>OVERRIDES</filename> to control
@@ -1829,9 +1829,9 @@
1829 </glossentry> 1829 </glossentry>
1830 </glossdiv> 1830 </glossdiv>
1831 1831
1832 <glossdiv id='var-glossary-p'><title>P</title> 1832 <glossdiv id='var-bb-glossary-p'><title>P</title>
1833 1833
1834 <glossentry id='var-P4DIR'><glossterm>P4DIR</glossterm> 1834 <glossentry id='var-bb-P4DIR'><glossterm>P4DIR</glossterm>
1835 <glossdef> 1835 <glossdef>
1836 <para> 1836 <para>
1837 The directory in which a local copy of a Perforce depot 1837 The directory in which a local copy of a Perforce depot
@@ -1840,14 +1840,14 @@
1840 </glossdef> 1840 </glossdef>
1841 </glossentry> 1841 </glossentry>
1842 1842
1843 <glossentry id='var-PACKAGES'><glossterm>PACKAGES</glossterm> 1843 <glossentry id='var-bb-PACKAGES'><glossterm>PACKAGES</glossterm>
1844 <glossdef> 1844 <glossdef>
1845 <para>The list of packages the recipe creates. 1845 <para>The list of packages the recipe creates.
1846 </para> 1846 </para>
1847 </glossdef> 1847 </glossdef>
1848 </glossentry> 1848 </glossentry>
1849 1849
1850 <glossentry id='var-PACKAGES_DYNAMIC'><glossterm>PACKAGES_DYNAMIC</glossterm> 1850 <glossentry id='var-bb-PACKAGES_DYNAMIC'><glossterm>PACKAGES_DYNAMIC</glossterm>
1851 <glossdef> 1851 <glossdef>
1852 <para> 1852 <para>
1853 A promise that your recipe satisfies runtime dependencies 1853 A promise that your recipe satisfies runtime dependencies
@@ -1856,7 +1856,7 @@
1856 does not actually satisfy the dependencies, it only states that 1856 does not actually satisfy the dependencies, it only states that
1857 they should be satisfied. 1857 they should be satisfied.
1858 For example, if a hard, runtime dependency 1858 For example, if a hard, runtime dependency
1859 (<link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>) 1859 (<link linkend='var-bb-RDEPENDS'><filename>RDEPENDS</filename></link>)
1860 of another package is satisfied during the build 1860 of another package is satisfied during the build
1861 through the <filename>PACKAGES_DYNAMIC</filename> 1861 through the <filename>PACKAGES_DYNAMIC</filename>
1862 variable, but a package with the module name is never actually 1862 variable, but a package with the module name is never actually
@@ -1865,7 +1865,7 @@
1865 </glossdef> 1865 </glossdef>
1866 </glossentry> 1866 </glossentry>
1867 1867
1868 <glossentry id='var-PE'><glossterm>PE</glossterm> 1868 <glossentry id='var-bb-PE'><glossterm>PE</glossterm>
1869 <glossdef> 1869 <glossdef>
1870 <para> 1870 <para>
1871 The epoch of the recipe. 1871 The epoch of the recipe.
@@ -1877,7 +1877,7 @@
1877 </glossdef> 1877 </glossdef>
1878 </glossentry> 1878 </glossentry>
1879 1879
1880 <glossentry id='var-PERSISTENT_DIR'><glossterm>PERSISTENT_DIR</glossterm> 1880 <glossentry id='var-bb-PERSISTENT_DIR'><glossterm>PERSISTENT_DIR</glossterm>
1881 <glossdef> 1881 <glossdef>
1882 <para> 1882 <para>
1883 Specifies the directory BitBake uses to store data that 1883 Specifies the directory BitBake uses to store data that
@@ -1889,7 +1889,7 @@
1889 </glossdef> 1889 </glossdef>
1890 </glossentry> 1890 </glossentry>
1891 1891
1892 <glossentry id='var-PF'><glossterm>PF</glossterm> 1892 <glossentry id='var-bb-PF'><glossterm>PF</glossterm>
1893 <glossdef> 1893 <glossdef>
1894 <para> 1894 <para>
1895 Specifies the recipe or package name and includes all version and revision 1895 Specifies the recipe or package name and includes all version and revision
@@ -1899,27 +1899,27 @@
1899 </glossdef> 1899 </glossdef>
1900 </glossentry> 1900 </glossentry>
1901 1901
1902 <glossentry id='var-PN'><glossterm>PN</glossterm> 1902 <glossentry id='var-bb-PN'><glossterm>PN</glossterm>
1903 <glossdef> 1903 <glossdef>
1904 <para>The recipe name.</para> 1904 <para>The recipe name.</para>
1905 </glossdef> 1905 </glossdef>
1906 </glossentry> 1906 </glossentry>
1907 1907
1908 <glossentry id='var-PR'><glossterm>PR</glossterm> 1908 <glossentry id='var-bb-PR'><glossterm>PR</glossterm>
1909 <glossdef> 1909 <glossdef>
1910 <para>The revision of the recipe. 1910 <para>The revision of the recipe.
1911 </para> 1911 </para>
1912 </glossdef> 1912 </glossdef>
1913 </glossentry> 1913 </glossentry>
1914 1914
1915 <glossentry id='var-PREFERRED_PROVIDER'><glossterm>PREFERRED_PROVIDER</glossterm> 1915 <glossentry id='var-bb-PREFERRED_PROVIDER'><glossterm>PREFERRED_PROVIDER</glossterm>
1916 <glossdef> 1916 <glossdef>
1917 <para> 1917 <para>
1918 Determines which recipe should be given preference when 1918 Determines which recipe should be given preference when
1919 multiple recipes provide the same item. 1919 multiple recipes provide the same item.
1920 You should always suffix the variable with the name of the 1920 You should always suffix the variable with the name of the
1921 provided item, and you should set it to the 1921 provided item, and you should set it to the
1922 <link linkend='var-PN'><filename>PN</filename></link> 1922 <link linkend='var-bb-PN'><filename>PN</filename></link>
1923 of the recipe to which you want to give precedence. 1923 of the recipe to which you want to give precedence.
1924 Some examples: 1924 Some examples:
1925 <literallayout class='monospaced'> 1925 <literallayout class='monospaced'>
@@ -1931,14 +1931,14 @@
1931 </glossdef> 1931 </glossdef>
1932 </glossentry> 1932 </glossentry>
1933 1933
1934 <glossentry id='var-PREFERRED_PROVIDERS'><glossterm>PREFERRED_PROVIDERS</glossterm> 1934 <glossentry id='var-bb-PREFERRED_PROVIDERS'><glossterm>PREFERRED_PROVIDERS</glossterm>
1935 <glossdef> 1935 <glossdef>
1936 <para> 1936 <para>
1937 Determines which recipe should be given preference for 1937 Determines which recipe should be given preference for
1938 cases where multiple recipes provide the same item. 1938 cases where multiple recipes provide the same item.
1939 Functionally, 1939 Functionally,
1940 <filename>PREFERRED_PROVIDERS</filename> is identical to 1940 <filename>PREFERRED_PROVIDERS</filename> is identical to
1941 <link linkend='var-PREFERRED_PROVIDER'><filename>PREFERRED_PROVIDER</filename></link>. 1941 <link linkend='var-bb-PREFERRED_PROVIDER'><filename>PREFERRED_PROVIDER</filename></link>.
1942 However, the <filename>PREFERRED_PROVIDERS</filename> 1942 However, the <filename>PREFERRED_PROVIDERS</filename>
1943 variable lets you define preferences for multiple 1943 variable lets you define preferences for multiple
1944 situations using the following form: 1944 situations using the following form:
@@ -1954,15 +1954,15 @@
1954 </glossdef> 1954 </glossdef>
1955 </glossentry> 1955 </glossentry>
1956 1956
1957 <glossentry id='var-PREFERRED_VERSION'><glossterm>PREFERRED_VERSION</glossterm> 1957 <glossentry id='var-bb-PREFERRED_VERSION'><glossterm>PREFERRED_VERSION</glossterm>
1958 <glossdef> 1958 <glossdef>
1959 <para> 1959 <para>
1960 If there are multiple versions of recipes available, this 1960 If there are multiple versions of recipes available, this
1961 variable determines which recipe should be given preference. 1961 variable determines which recipe should be given preference.
1962 You must always suffix the variable with the 1962 You must always suffix the variable with the
1963 <link linkend='var-PN'><filename>PN</filename></link> 1963 <link linkend='var-bb-PN'><filename>PN</filename></link>
1964 you want to select, and you should set 1964 you want to select, and you should set
1965 <link linkend='var-PV'><filename>PV</filename></link> 1965 <link linkend='var-bb-PV'><filename>PV</filename></link>
1966 accordingly for precedence. 1966 accordingly for precedence.
1967 </para> 1967 </para>
1968 1968
@@ -1989,7 +1989,7 @@
1989 </glossdef> 1989 </glossdef>
1990 </glossentry> 1990 </glossentry>
1991 1991
1992 <glossentry id='var-PREMIRRORS'><glossterm>PREMIRRORS</glossterm> 1992 <glossentry id='var-bb-PREMIRRORS'><glossterm>PREMIRRORS</glossterm>
1993 <glossdef> 1993 <glossdef>
1994 <para> 1994 <para>
1995 Specifies additional paths from which BitBake gets source code. 1995 Specifies additional paths from which BitBake gets source code.
@@ -1998,7 +1998,7 @@
1998 If that location fails, the build system tries locations 1998 If that location fails, the build system tries locations
1999 defined by <filename>PREMIRRORS</filename>, the upstream 1999 defined by <filename>PREMIRRORS</filename>, the upstream
2000 source, and then locations specified by 2000 source, and then locations specified by
2001 <link linkend='var-MIRRORS'><filename>MIRRORS</filename></link> 2001 <link linkend='var-bb-MIRRORS'><filename>MIRRORS</filename></link>
2002 in that order. 2002 in that order.
2003 </para> 2003 </para>
2004 2004
@@ -2022,20 +2022,20 @@
2022 </glossdef> 2022 </glossdef>
2023 </glossentry> 2023 </glossentry>
2024 2024
2025 <glossentry id='var-PROVIDES'><glossterm>PROVIDES</glossterm> 2025 <glossentry id='var-bb-PROVIDES'><glossterm>PROVIDES</glossterm>
2026 <glossdef> 2026 <glossdef>
2027 <para> 2027 <para>
2028 A list of aliases by which a particular recipe can be 2028 A list of aliases by which a particular recipe can be
2029 known. 2029 known.
2030 By default, a recipe's own 2030 By default, a recipe's own
2031 <filename><link linkend='var-PN'>PN</link></filename> 2031 <filename><link linkend='var-bb-PN'>PN</link></filename>
2032 is implicitly already in its <filename>PROVIDES</filename> 2032 is implicitly already in its <filename>PROVIDES</filename>
2033 list. 2033 list.
2034 If a recipe uses <filename>PROVIDES</filename>, the 2034 If a recipe uses <filename>PROVIDES</filename>, the
2035 additional aliases are synonyms for the recipe and can 2035 additional aliases are synonyms for the recipe and can
2036 be useful satisfying dependencies of other recipes during 2036 be useful satisfying dependencies of other recipes during
2037 the build as specified by 2037 the build as specified by
2038 <filename><link linkend='var-DEPENDS'>DEPENDS</link></filename>. 2038 <filename><link linkend='var-bb-DEPENDS'>DEPENDS</link></filename>.
2039 </para> 2039 </para>
2040 2040
2041 <para> 2041 <para>
@@ -2059,7 +2059,7 @@
2059 virtual target in <filename>PROVIDES</filename>. 2059 virtual target in <filename>PROVIDES</filename>.
2060 Recipes that depend on the functionality in question can 2060 Recipes that depend on the functionality in question can
2061 include the virtual target in 2061 include the virtual target in
2062 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 2062 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link>
2063 to leave the choice of provider open. 2063 to leave the choice of provider open.
2064 </para> 2064 </para>
2065 2065
@@ -2072,11 +2072,11 @@
2072 </glossdef> 2072 </glossdef>
2073 </glossentry> 2073 </glossentry>
2074 2074
2075 <glossentry id='var-PRSERV_HOST'><glossterm>PRSERV_HOST</glossterm> 2075 <glossentry id='var-bb-PRSERV_HOST'><glossterm>PRSERV_HOST</glossterm>
2076 <glossdef> 2076 <glossdef>
2077 <para> 2077 <para>
2078 The network based 2078 The network based
2079 <link linkend='var-PR'><filename>PR</filename></link> 2079 <link linkend='var-bb-PR'><filename>PR</filename></link>
2080 service host and port. 2080 service host and port.
2081 </para> 2081 </para>
2082 2082
@@ -2094,7 +2094,7 @@
2094 </glossdef> 2094 </glossdef>
2095 </glossentry> 2095 </glossentry>
2096 2096
2097 <glossentry id='var-PV'><glossterm>PV</glossterm> 2097 <glossentry id='var-bb-PV'><glossterm>PV</glossterm>
2098 <glossdef> 2098 <glossdef>
2099 <para>The version of the recipe. 2099 <para>The version of the recipe.
2100 </para> 2100 </para>
@@ -2108,9 +2108,9 @@
2108 </glossdiv> 2108 </glossdiv>
2109--> 2109-->
2110 2110
2111 <glossdiv id='var-glossary-r'><title>R</title> 2111 <glossdiv id='var-bb-glossary-r'><title>R</title>
2112 2112
2113 <glossentry id='var-RDEPENDS'><glossterm>RDEPENDS</glossterm> 2113 <glossentry id='var-bb-RDEPENDS'><glossterm>RDEPENDS</glossterm>
2114 <glossdef> 2114 <glossdef>
2115 <para> 2115 <para>
2116 Lists a package's runtime dependencies (i.e. other packages) 2116 Lists a package's runtime dependencies (i.e. other packages)
@@ -2165,13 +2165,13 @@
2165 2165
2166 <para> 2166 <para>
2167 For information on build-time dependencies, see the 2167 For information on build-time dependencies, see the
2168 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 2168 <link linkend='var-bb-DEPENDS'><filename>DEPENDS</filename></link>
2169 variable. 2169 variable.
2170 </para> 2170 </para>
2171 </glossdef> 2171 </glossdef>
2172 </glossentry> 2172 </glossentry>
2173 2173
2174 <glossentry id='var-REPODIR'><glossterm>REPODIR</glossterm> 2174 <glossentry id='var-bb-REPODIR'><glossterm>REPODIR</glossterm>
2175 <glossdef> 2175 <glossdef>
2176 <para> 2176 <para>
2177 The directory in which a local copy of a 2177 The directory in which a local copy of a
@@ -2181,14 +2181,14 @@
2181 </glossdef> 2181 </glossdef>
2182 </glossentry> 2182 </glossentry>
2183 2183
2184 <glossentry id='var-RPROVIDES'><glossterm>RPROVIDES</glossterm> 2184 <glossentry id='var-bb-RPROVIDES'><glossterm>RPROVIDES</glossterm>
2185 <glossdef> 2185 <glossdef>
2186 <para> 2186 <para>
2187 A list of package name aliases that a package also provides. 2187 A list of package name aliases that a package also provides.
2188 These aliases are useful for satisfying runtime dependencies 2188 These aliases are useful for satisfying runtime dependencies
2189 of other packages both during the build and on the target 2189 of other packages both during the build and on the target
2190 (as specified by 2190 (as specified by
2191 <filename><link linkend='var-RDEPENDS'>RDEPENDS</link></filename>). 2191 <filename><link linkend='var-bb-RDEPENDS'>RDEPENDS</link></filename>).
2192 </para> 2192 </para>
2193 <para> 2193 <para>
2194 As with all package-controlling variables, you must always 2194 As with all package-controlling variables, you must always
@@ -2201,7 +2201,7 @@
2201 </glossdef> 2201 </glossdef>
2202 </glossentry> 2202 </glossentry>
2203 2203
2204 <glossentry id='var-RRECOMMENDS'><glossterm>RRECOMMENDS</glossterm> 2204 <glossentry id='var-bb-RRECOMMENDS'><glossterm>RRECOMMENDS</glossterm>
2205 <glossdef> 2205 <glossdef>
2206 <para> 2206 <para>
2207 A list of packages that extends the usability of a package 2207 A list of packages that extends the usability of a package
@@ -2210,7 +2210,7 @@
2210 packages in order to successfully build, but needs them for 2210 packages in order to successfully build, but needs them for
2211 the extended usability. 2211 the extended usability.
2212 To specify runtime dependencies for packages, see the 2212 To specify runtime dependencies for packages, see the
2213 <filename><link linkend='var-RDEPENDS'>RDEPENDS</link></filename> 2213 <filename><link linkend='var-bb-RDEPENDS'>RDEPENDS</link></filename>
2214 variable. 2214 variable.
2215 </para> 2215 </para>
2216 2216
@@ -2243,15 +2243,15 @@
2243 2243
2244 </glossdiv> 2244 </glossdiv>
2245 2245
2246 <glossdiv id='var-glossary-s'><title>S</title> 2246 <glossdiv id='var-bb-glossary-s'><title>S</title>
2247 2247
2248 <glossentry id='var-SECTION'><glossterm>SECTION</glossterm> 2248 <glossentry id='var-bb-SECTION'><glossterm>SECTION</glossterm>
2249 <glossdef> 2249 <glossdef>
2250 <para>The section in which packages should be categorized.</para> 2250 <para>The section in which packages should be categorized.</para>
2251 </glossdef> 2251 </glossdef>
2252 </glossentry> 2252 </glossentry>
2253 2253
2254 <glossentry id='var-SRC_URI'><glossterm>SRC_URI</glossterm> 2254 <glossentry id='var-bb-SRC_URI'><glossterm>SRC_URI</glossterm>
2255 <glossdef> 2255 <glossdef>
2256 <para> 2256 <para>
2257 The list of source files - local or remote. 2257 The list of source files - local or remote.
@@ -2272,7 +2272,7 @@
2272 the metadata, 2272 the metadata,
2273 from the local machine. 2273 from the local machine.
2274 The path is relative to the 2274 The path is relative to the
2275 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> 2275 <link linkend='var-bb-FILESPATH'><filename>FILESPATH</filename></link>
2276 variable.</para></listitem> 2276 variable.</para></listitem>
2277 <listitem><para><emphasis><filename>bzr://</filename> -</emphasis> Fetches files from a 2277 <listitem><para><emphasis><filename>bzr://</filename> -</emphasis> Fetches files from a
2278 Bazaar revision control repository.</para></listitem> 2278 Bazaar revision control repository.</para></listitem>
@@ -2322,7 +2322,7 @@
2322 </glossdef> 2322 </glossdef>
2323 </glossentry> 2323 </glossentry>
2324 2324
2325 <glossentry id='var-SRCDATE'><glossterm>SRCDATE</glossterm> 2325 <glossentry id='var-bb-SRCDATE'><glossterm>SRCDATE</glossterm>
2326 <glossdef> 2326 <glossdef>
2327 <para> 2327 <para>
2328 The date of the source code used to build the package. 2328 The date of the source code used to build the package.
@@ -2331,7 +2331,7 @@
2331 </glossdef> 2331 </glossdef>
2332 </glossentry> 2332 </glossentry>
2333 2333
2334 <glossentry id='var-SRCREV'><glossterm>SRCREV</glossterm> 2334 <glossentry id='var-bb-SRCREV'><glossterm>SRCREV</glossterm>
2335 <glossdef> 2335 <glossdef>
2336 <para> 2336 <para>
2337 The revision of the source code used to build the package. 2337 The revision of the source code used to build the package.
@@ -2344,13 +2344,13 @@
2344 </glossdef> 2344 </glossdef>
2345 </glossentry> 2345 </glossentry>
2346 2346
2347 <glossentry id='var-SRCREV_FORMAT'><glossterm>SRCREV_FORMAT</glossterm> 2347 <glossentry id='var-bb-SRCREV_FORMAT'><glossterm>SRCREV_FORMAT</glossterm>
2348 <glossdef> 2348 <glossdef>
2349 <para> 2349 <para>
2350 Helps construct valid 2350 Helps construct valid
2351 <link linkend='var-SRCREV'><filename>SRCREV</filename></link> 2351 <link linkend='var-bb-SRCREV'><filename>SRCREV</filename></link>
2352 values when multiple source controlled URLs are used in 2352 values when multiple source controlled URLs are used in
2353 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>. 2353 <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>.
2354 </para> 2354 </para>
2355 2355
2356 <para> 2356 <para>
@@ -2371,7 +2371,7 @@
2371 </glossdef> 2371 </glossdef>
2372 </glossentry> 2372 </glossentry>
2373 2373
2374 <glossentry id='var-STAMP'><glossterm>STAMP</glossterm> 2374 <glossentry id='var-bb-STAMP'><glossterm>STAMP</glossterm>
2375 <glossdef> 2375 <glossdef>
2376 <para> 2376 <para>
2377 Specifies the base path used to create recipe stamp files. 2377 Specifies the base path used to create recipe stamp files.
@@ -2381,12 +2381,12 @@
2381 </glossdef> 2381 </glossdef>
2382 </glossentry> 2382 </glossentry>
2383 2383
2384 <glossentry id='var-STAMPCLEAN'><glossterm>STAMPCLEAN</glossterm> 2384 <glossentry id='var-bb-STAMPCLEAN'><glossterm>STAMPCLEAN</glossterm>
2385 <glossdef> 2385 <glossdef>
2386 <para> 2386 <para>
2387 Specifies the base path used to create recipe stamp files. 2387 Specifies the base path used to create recipe stamp files.
2388 Unlike the 2388 Unlike the
2389 <link linkend='var-STAMP'><filename>STAMP</filename></link> 2389 <link linkend='var-bb-STAMP'><filename>STAMP</filename></link>
2390 variable, <filename>STAMPCLEAN</filename> can contain 2390 variable, <filename>STAMPCLEAN</filename> can contain
2391 wildcards to match the range of files a clean operation 2391 wildcards to match the range of files a clean operation
2392 should remove. 2392 should remove.
@@ -2396,7 +2396,7 @@
2396 </glossdef> 2396 </glossdef>
2397 </glossentry> 2397 </glossentry>
2398 2398
2399 <glossentry id='var-SUMMARY'><glossterm>SUMMARY</glossterm> 2399 <glossentry id='var-bb-SUMMARY'><glossterm>SUMMARY</glossterm>
2400 <glossdef> 2400 <glossdef>
2401 <para> 2401 <para>
2402 A short summary for the recipe, which is 72 characters or less. 2402 A short summary for the recipe, which is 72 characters or less.
@@ -2404,7 +2404,7 @@
2404 </glossdef> 2404 </glossdef>
2405 </glossentry> 2405 </glossentry>
2406 2406
2407 <glossentry id='var-SVNDIR'><glossterm>SVNDIR</glossterm> 2407 <glossentry id='var-bb-SVNDIR'><glossterm>SVNDIR</glossterm>
2408 <glossdef> 2408 <glossdef>
2409 <para> 2409 <para>
2410 The directory in which files checked out of a Subversion 2410 The directory in which files checked out of a Subversion
@@ -2415,9 +2415,9 @@
2415 2415
2416 </glossdiv> 2416 </glossdiv>
2417 2417
2418 <glossdiv id='var-glossary-t'><title>T</title> 2418 <glossdiv id='var-bb-glossary-t'><title>T</title>
2419 2419
2420 <glossentry id='var-T'><glossterm>T</glossterm> 2420 <glossentry id='var-bb-T'><glossterm>T</glossterm>
2421 <glossdef> 2421 <glossdef>
2422 <para>Points to a directory were BitBake places 2422 <para>Points to a directory were BitBake places
2423 temporary files, which consist mostly of task logs and 2423 temporary files, which consist mostly of task logs and
@@ -2426,7 +2426,7 @@
2426 </glossdef> 2426 </glossdef>
2427 </glossentry> 2427 </glossentry>
2428 2428
2429 <glossentry id='var-TOPDIR'><glossterm>TOPDIR</glossterm> 2429 <glossentry id='var-bb-TOPDIR'><glossterm>TOPDIR</glossterm>
2430 <glossdef> 2430 <glossdef>
2431 <para> 2431 <para>
2432 Points to the build directory. 2432 Points to the build directory.