diff options
| author | Robert P. J. Day <rpjday@crashcourse.ca> | 2021-03-15 07:54:24 -0400 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-03-15 21:47:42 +0000 |
| commit | 7a348cdc3ad084a1799b0939c3192691049ba08e (patch) | |
| tree | 51f7451851a72d25ecda3fa5e925fb17ea7ba670 /bitbake/doc | |
| parent | a9098e642367a775c60dbb677cbf041eaf53cf83 (diff) | |
| download | poky-7a348cdc3ad084a1799b0939c3192691049ba08e.tar.gz | |
bitbake: doc: move BBFILES_DYNAMIC for alphabetical order
Since BBFILES_DYNAMIC does not have a "BB_" prefix, it belongs further
down in the variable glossary.
(Bitbake rev: 493f291601c7680f8b8146f358c545fcb5f53cc9)
Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
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-ref-variables.rst | 78 |
1 files changed, 39 insertions, 39 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index d8c88c61df..1528b04065 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst | |||
| @@ -270,45 +270,6 @@ overview of their function and contents. | |||
| 270 | ``my-recipe.bb`` is executing, the ``BB_FILENAME`` variable contains | 270 | ``my-recipe.bb`` is executing, the ``BB_FILENAME`` variable contains |
| 271 | "/foo/path/my-recipe.bb". | 271 | "/foo/path/my-recipe.bb". |
| 272 | 272 | ||
| 273 | :term:`BBFILES_DYNAMIC` | ||
| 274 | Activates content depending on presence of identified layers. You | ||
| 275 | identify the layers by the collections that the layers define. | ||
| 276 | |||
| 277 | Use the ``BBFILES_DYNAMIC`` variable to avoid ``.bbappend`` files whose | ||
| 278 | corresponding ``.bb`` file is in a layer that attempts to modify other | ||
| 279 | layers through ``.bbappend`` but does not want to introduce a hard | ||
| 280 | dependency on those other layers. | ||
| 281 | |||
| 282 | Additionally you can prefix the rule with "!" to add ``.bbappend`` and | ||
| 283 | ``.bb`` files in case a layer is not present. Use this avoid hard | ||
| 284 | dependency on those other layers. | ||
| 285 | |||
| 286 | Use the following form for ``BBFILES_DYNAMIC``: :: | ||
| 287 | |||
| 288 | collection_name:filename_pattern | ||
| 289 | |||
| 290 | The following example identifies two collection names and two filename | ||
| 291 | patterns: :: | ||
| 292 | |||
| 293 | BBFILES_DYNAMIC += "\ | ||
| 294 | clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \ | ||
| 295 | core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \ | ||
| 296 | " | ||
| 297 | |||
| 298 | When the collection name is prefixed with "!" it will add the file pattern in case | ||
| 299 | the layer is absent: :: | ||
| 300 | |||
| 301 | BBFILES_DYNAMIC += "\ | ||
| 302 | !clang-layer:${LAYERDIR}/backfill/meta-clang/*/*/*.bb \ | ||
| 303 | " | ||
| 304 | |||
| 305 | This next example shows an error message that occurs because invalid | ||
| 306 | entries are found, which cause parsing to abort: :: | ||
| 307 | |||
| 308 | ERROR: BBFILES_DYNAMIC entries must be of the form {!}<collection name>:<filename pattern>, not: | ||
| 309 | /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend | ||
| 310 | /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend | ||
| 311 | |||
| 312 | :term:`BB_GENERATE_MIRROR_TARBALLS` | 273 | :term:`BB_GENERATE_MIRROR_TARBALLS` |
| 313 | Causes tarballs of the Git repositories, including the Git metadata, | 274 | Causes tarballs of the Git repositories, including the Git metadata, |
| 314 | to be placed in the :term:`DL_DIR` directory. Anyone | 275 | to be placed in the :term:`DL_DIR` directory. Anyone |
| @@ -684,6 +645,45 @@ overview of their function and contents. | |||
| 684 | For details on the syntax, see the documentation by following the | 645 | For details on the syntax, see the documentation by following the |
| 685 | previous link. | 646 | previous link. |
| 686 | 647 | ||
| 648 | :term:`BBFILES_DYNAMIC` | ||
| 649 | Activates content depending on presence of identified layers. You | ||
| 650 | identify the layers by the collections that the layers define. | ||
| 651 | |||
| 652 | Use the ``BBFILES_DYNAMIC`` variable to avoid ``.bbappend`` files whose | ||
| 653 | corresponding ``.bb`` file is in a layer that attempts to modify other | ||
| 654 | layers through ``.bbappend`` but does not want to introduce a hard | ||
| 655 | dependency on those other layers. | ||
| 656 | |||
| 657 | Additionally you can prefix the rule with "!" to add ``.bbappend`` and | ||
| 658 | ``.bb`` files in case a layer is not present. Use this avoid hard | ||
| 659 | dependency on those other layers. | ||
| 660 | |||
| 661 | Use the following form for ``BBFILES_DYNAMIC``: :: | ||
| 662 | |||
| 663 | collection_name:filename_pattern | ||
| 664 | |||
| 665 | The following example identifies two collection names and two filename | ||
| 666 | patterns: :: | ||
| 667 | |||
| 668 | BBFILES_DYNAMIC += "\ | ||
| 669 | clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \ | ||
| 670 | core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \ | ||
| 671 | " | ||
| 672 | |||
| 673 | When the collection name is prefixed with "!" it will add the file pattern in case | ||
| 674 | the layer is absent: :: | ||
| 675 | |||
| 676 | BBFILES_DYNAMIC += "\ | ||
| 677 | !clang-layer:${LAYERDIR}/backfill/meta-clang/*/*/*.bb \ | ||
| 678 | " | ||
| 679 | |||
| 680 | This next example shows an error message that occurs because invalid | ||
| 681 | entries are found, which cause parsing to abort: :: | ||
| 682 | |||
| 683 | ERROR: BBFILES_DYNAMIC entries must be of the form {!}<collection name>:<filename pattern>, not: | ||
| 684 | /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend | ||
| 685 | /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend | ||
| 686 | |||
| 687 | :term:`BBINCLUDED` | 687 | :term:`BBINCLUDED` |
| 688 | Contains a space-separated list of all of all files that BitBake's | 688 | Contains a space-separated list of all of all files that BitBake's |
| 689 | parser included during parsing of the current file. | 689 | parser included during parsing of the current file. |
