[PATCH v3] ref-manual/variables: document the 'dynamic layer' concept

[PATCH v3] ref-manual/variables: document the 'dynamic layer' concept

[Minwoo Choi]

This patch documents the "dynamic layer" concept for BBFILES_DYNAMIC.
While not previously in the manual, this is an informal convention
widely used in major layers such as meta-intel, meta-ti, and meta-freescale
to name directories containing conditional content.

[YOCTO #15713]

Signed-off-by: Minwoo Choi <mw.choi@telica.co.kr>
---
 documentation/ref-manual/variables.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index a8cbb87cf..c16e41626 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -841,8 +841,9 @@ system and gives an overview of their function and contents.
       previous link.
 
    :term:`BBFILES_DYNAMIC`
-      Activates content when identified layers are present. You identify
-      the layers by the collections that the layers define.
+      Activates content when identified layers are present. This mechanism
+      is commonly referred to as "dynamic layers". You identify the layers
+      by the collections that the layers define.
 
       Use the :term:`BBFILES_DYNAMIC` variable to avoid ``.bbappend`` files
       whose corresponding ``.bb`` file is in a layer that attempts to
@@ -856,8 +857,8 @@ system and gives an overview of their function and contents.
       filename patterns::
 
          BBFILES_DYNAMIC += " \
-            clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \
-            core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \
+            clang-layer:${LAYERDIR}/dynamic-layers/meta-clang/*/*/*.bbappend \
+            core:${LAYERDIR}/dynamic-layers/openembedded-core/meta/*/*/*.bbappend \
             "
 
       This next example shows an error message that occurs because invalid
-- 
2.43.0

Re: [docs] [PATCH v3] ref-manual/variables: document the 'dynamic layer' concept

[Antonin Godard]

Hi,

On Wed May 13, 2026 at 9:31 PM CEST, 최민우 wrote:
> This patch documents the "dynamic layer" concept for BBFILES_DYNAMIC.
> While not previously in the manual, this is an informal convention
> widely used in major layers such as meta-intel, meta-ti, and meta-freescale
> to name directories containing conditional content.
>
> [YOCTO #15713]
>
> Signed-off-by: Minwoo Choi <mw.choi@telica.co.kr>
> ---
>  documentation/ref-manual/variables.rst | 9 +++++----
>  1 file changed, 5 insertions(+), 4 deletions(-)
>
> diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
> index a8cbb87cf..c16e41626 100644
> --- a/documentation/ref-manual/variables.rst
> +++ b/documentation/ref-manual/variables.rst
> @@ -841,8 +841,9 @@ system and gives an overview of their function and contents.
>        previous link.
>  
>     :term:`BBFILES_DYNAMIC`
> -      Activates content when identified layers are present. You identify
> -      the layers by the collections that the layers define.
> +      Activates content when identified layers are present. This mechanism
> +      is commonly referred to as "dynamic layers". You identify the layers
> +      by the collections that the layers define.
>  
>        Use the :term:`BBFILES_DYNAMIC` variable to avoid ``.bbappend`` files
>        whose corresponding ``.bb`` file is in a layer that attempts to
> @@ -856,8 +857,8 @@ system and gives an overview of their function and contents.
>        filename patterns::
>  
>           BBFILES_DYNAMIC += " \
> -            clang-layer:${LAYERDIR}/bbappends/meta-clang/*/*/*.bbappend \
> -            core:${LAYERDIR}/bbappends/openembedded-core/meta/*/*/*.bbappend \
> +            clang-layer:${LAYERDIR}/dynamic-layers/meta-clang/*/*/*.bbappend \
> +            core:${LAYERDIR}/dynamic-layers/openembedded-core/meta/*/*/*.bbappend \

For consistency could you also update this in the error message below?

 ERROR: BBFILES_DYNAMIC entries must be of the form <collection name>:<filename pattern>, not:
     /work/my-layer/bbappends/meta-security-isafw/*/*/*.bbappend
     /work/my-layer/bbappends/openembedded-core/meta/*/*/*.bbappend

Thanks,
Antonin