summaryrefslogtreecommitdiffstats
path: root/bitbake
diff options
context:
space:
mode:
authorRobert P. J. Day <rpjday@crashcourse.ca>2021-03-15 07:54:24 -0400
committerRichard Purdie <richard.purdie@linuxfoundation.org>2021-03-15 21:47:42 +0000
commit7a348cdc3ad084a1799b0939c3192691049ba08e (patch)
tree51f7451851a72d25ecda3fa5e925fb17ea7ba670 /bitbake
parenta9098e642367a775c60dbb677cbf041eaf53cf83 (diff)
downloadpoky-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')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst78
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.