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. |