diff options
| author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-09-10 09:30:53 -0700 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-09-12 16:50:10 +0100 |
| commit | cc2626727c61025b5cf0fcc214ddb896de7bbc39 (patch) | |
| tree | 736c76df3790681a54eefd46ebee5c31b6e3ac19 | |
| parent | 2fe021399773b1c710dd841fce76205bbe36500a (diff) | |
| download | poky-cc2626727c61025b5cf0fcc214ddb896de7bbc39.tar.gz | |
ref-manual: Re-ordered some B* variables to be in alphabetical order.
(From yocto-docs rev: 75e170bb84d263a514e79c02c8628ef44290a5b2)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
| -rw-r--r-- | documentation/ref-manual/ref-variables.xml | 150 |
1 files changed, 75 insertions, 75 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 3148d0f154..2414d3b036 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
| @@ -493,6 +493,14 @@ | |||
| 493 | </glossdef> | 493 | </glossdef> |
| 494 | </glossentry> | 494 | </glossentry> |
| 495 | 495 | ||
| 496 | <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm> | ||
| 497 | <glossdef> | ||
| 498 | <para>The maximum number of tasks BitBake should run in parallel at any one time. | ||
| 499 | If your host development system supports multiple cores a good rule of thumb | ||
| 500 | is to set this variable to twice the number of cores.</para> | ||
| 501 | </glossdef> | ||
| 502 | </glossentry> | ||
| 503 | |||
| 496 | <glossentry id='var-BBCLASSEXTEND'><glossterm>BBCLASSEXTEND</glossterm> | 504 | <glossentry id='var-BBCLASSEXTEND'><glossterm>BBCLASSEXTEND</glossterm> |
| 497 | <glossdef> | 505 | <glossdef> |
| 498 | <para> | 506 | <para> |
| @@ -517,74 +525,6 @@ | |||
| 517 | </glossdef> | 525 | </glossdef> |
| 518 | </glossentry> | 526 | </glossentry> |
| 519 | 527 | ||
| 520 | <glossentry id='var-BBMASK'><glossterm>BBMASK</glossterm> | ||
| 521 | <glossdef> | ||
| 522 | <para> | ||
| 523 | Prevents BitBake from processing recipes and recipe | ||
| 524 | append files. | ||
| 525 | Use the <filename>BBMASK</filename> variable from within the | ||
| 526 | <filename>conf/local.conf</filename> file found | ||
| 527 | in the | ||
| 528 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. | ||
| 529 | </para> | ||
| 530 | |||
| 531 | <para> | ||
| 532 | You can use the <filename>BBMASK</filename> variable | ||
| 533 | to "hide" these <filename>.bb</filename> and | ||
| 534 | <filename>.bbappend</filename> files. | ||
| 535 | BitBake ignores any recipe or recipe append files that | ||
| 536 | match the expression. | ||
| 537 | It is as if BitBake does not see them at all. | ||
| 538 | Consequently, matching files are not parsed or otherwise | ||
| 539 | used by BitBake.</para> | ||
| 540 | <para> | ||
| 541 | The value you provide is passed to Python's regular | ||
| 542 | expression compiler. | ||
| 543 | The expression is compared against the full paths to | ||
| 544 | the files. | ||
| 545 | For complete syntax information, see Python's | ||
| 546 | documentation at | ||
| 547 | <ulink url='http://docs.python.org/release/2.3/lib/re-syntax.html'></ulink>. | ||
| 548 | </para> | ||
| 549 | |||
| 550 | <para> | ||
| 551 | The following example uses a complete regular expression | ||
| 552 | to tell BitBake to ignore all recipe and recipe append | ||
| 553 | files in the <filename>/meta-ti/recipes-misc/</filename> | ||
| 554 | directory: | ||
| 555 | <literallayout class='monospaced'> | ||
| 556 | BBMASK = "/meta-ti/recipes-misc/" | ||
| 557 | </literallayout> | ||
| 558 | If you want to mask out multiple directories or recipes, | ||
| 559 | use the vertical bar to separate the regular expression | ||
| 560 | fragments. | ||
| 561 | This next example masks out multiple directories and | ||
| 562 | individual recipes: | ||
| 563 | <literallayout class='monospaced'> | ||
| 564 | BBMASK = "meta-ti/recipes-misc/|meta-ti/recipes-ti/packagegroup/" | ||
| 565 | BBMASK .= "|.*meta-oe/recipes-support/" | ||
| 566 | BBMASK .= "|.*openldap" | ||
| 567 | BBMASK .= "|.*opencv" | ||
| 568 | BBMASK .= "|.*lzma" | ||
| 569 | </literallayout> | ||
| 570 | Notice how the vertical bar is used to append the fragments. | ||
| 571 | <note> | ||
| 572 | When specifying a directory name, use the trailing | ||
| 573 | slash character to ensure you match just that directory | ||
| 574 | name. | ||
| 575 | </note> | ||
| 576 | </para> | ||
| 577 | </glossdef> | ||
| 578 | </glossentry> | ||
| 579 | |||
| 580 | <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm> | ||
| 581 | <glossdef> | ||
| 582 | <para>The maximum number of tasks BitBake should run in parallel at any one time. | ||
| 583 | If your host development system supports multiple cores a good rule of thumb | ||
| 584 | is to set this variable to twice the number of cores.</para> | ||
| 585 | </glossdef> | ||
| 586 | </glossentry> | ||
| 587 | |||
| 588 | <glossentry id='var-BBFILE_COLLECTIONS'><glossterm>BBFILE_COLLECTIONS</glossterm> | 528 | <glossentry id='var-BBFILE_COLLECTIONS'><glossterm>BBFILE_COLLECTIONS</glossterm> |
| 589 | <glossdef> | 529 | <glossdef> |
| 590 | <para>Lists the names of configured layers. | 530 | <para>Lists the names of configured layers. |
| @@ -644,13 +584,6 @@ | |||
| 644 | </glossdef> | 584 | </glossdef> |
| 645 | </glossentry> | 585 | </glossentry> |
| 646 | 586 | ||
| 647 | <glossentry id='var-BBPATH'><glossterm>BBPATH</glossterm> | ||
| 648 | <glossdef> | ||
| 649 | <para>Used by BitBake to locate <filename>.bbclass</filename> and configuration files. | ||
| 650 | This variable is analogous to the <filename>PATH</filename> variable.</para> | ||
| 651 | </glossdef> | ||
| 652 | </glossentry> | ||
| 653 | |||
| 654 | <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm> | 587 | <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm> |
| 655 | <glossdef> | 588 | <glossdef> |
| 656 | <para>Variable that controls how BitBake displays logs on build failure.</para> | 589 | <para>Variable that controls how BitBake displays logs on build failure.</para> |
| @@ -710,6 +643,73 @@ Core layer for images cannot be removed | |||
| 710 | </glossdef> | 643 | </glossdef> |
| 711 | </glossentry> | 644 | </glossentry> |
| 712 | 645 | ||
| 646 | <glossentry id='var-BBMASK'><glossterm>BBMASK</glossterm> | ||
| 647 | <glossdef> | ||
| 648 | <para> | ||
| 649 | Prevents BitBake from processing recipes and recipe | ||
| 650 | append files. | ||
| 651 | Use the <filename>BBMASK</filename> variable from within the | ||
| 652 | <filename>conf/local.conf</filename> file found | ||
| 653 | in the | ||
| 654 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. | ||
| 655 | </para> | ||
| 656 | |||
| 657 | <para> | ||
| 658 | You can use the <filename>BBMASK</filename> variable | ||
| 659 | to "hide" these <filename>.bb</filename> and | ||
| 660 | <filename>.bbappend</filename> files. | ||
| 661 | BitBake ignores any recipe or recipe append files that | ||
| 662 | match the expression. | ||
| 663 | It is as if BitBake does not see them at all. | ||
| 664 | Consequently, matching files are not parsed or otherwise | ||
| 665 | used by BitBake.</para> | ||
| 666 | <para> | ||
| 667 | The value you provide is passed to Python's regular | ||
| 668 | expression compiler. | ||
| 669 | The expression is compared against the full paths to | ||
| 670 | the files. | ||
| 671 | For complete syntax information, see Python's | ||
| 672 | documentation at | ||
| 673 | <ulink url='http://docs.python.org/release/2.3/lib/re-syntax.html'></ulink>. | ||
| 674 | </para> | ||
| 675 | |||
| 676 | <para> | ||
| 677 | The following example uses a complete regular expression | ||
| 678 | to tell BitBake to ignore all recipe and recipe append | ||
| 679 | files in the <filename>/meta-ti/recipes-misc/</filename> | ||
| 680 | directory: | ||
| 681 | <literallayout class='monospaced'> | ||
| 682 | BBMASK = "/meta-ti/recipes-misc/" | ||
| 683 | </literallayout> | ||
| 684 | If you want to mask out multiple directories or recipes, | ||
| 685 | use the vertical bar to separate the regular expression | ||
| 686 | fragments. | ||
| 687 | This next example masks out multiple directories and | ||
| 688 | individual recipes: | ||
| 689 | <literallayout class='monospaced'> | ||
| 690 | BBMASK = "meta-ti/recipes-misc/|meta-ti/recipes-ti/packagegroup/" | ||
| 691 | BBMASK .= "|.*meta-oe/recipes-support/" | ||
| 692 | BBMASK .= "|.*openldap" | ||
| 693 | BBMASK .= "|.*opencv" | ||
| 694 | BBMASK .= "|.*lzma" | ||
| 695 | </literallayout> | ||
| 696 | Notice how the vertical bar is used to append the fragments. | ||
| 697 | <note> | ||
| 698 | When specifying a directory name, use the trailing | ||
| 699 | slash character to ensure you match just that directory | ||
| 700 | name. | ||
| 701 | </note> | ||
| 702 | </para> | ||
| 703 | </glossdef> | ||
| 704 | </glossentry> | ||
| 705 | |||
| 706 | <glossentry id='var-BBPATH'><glossterm>BBPATH</glossterm> | ||
| 707 | <glossdef> | ||
| 708 | <para>Used by BitBake to locate <filename>.bbclass</filename> and configuration files. | ||
| 709 | This variable is analogous to the <filename>PATH</filename> variable.</para> | ||
| 710 | </glossdef> | ||
| 711 | </glossentry> | ||
| 712 | |||
| 713 | <glossentry id='var-BINCONFIG_GLOB'><glossterm>BINCONFIG_GLOB</glossterm> | 713 | <glossentry id='var-BINCONFIG_GLOB'><glossterm>BINCONFIG_GLOB</glossterm> |
| 714 | <glossdef> | 714 | <glossdef> |
| 715 | <para> | 715 | <para> |
