diff mbox series

ref-manual/variables: document the 'dynamic layer' concept

Message ID 20260511093446.2350-1-mw.choi@telica.co.kr
State Superseded
Headers show
Series ref-manual/variables: document the 'dynamic layer' concept | expand

Commit Message

Minwoo Choi May 11, 2026, 9:34 a.m. UTC
Signed-off-by: Minwoo Choi <mw.choi@telica.co.kr>
---
 documentation/ref-manual/variables.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

Comments

Quentin Schulz May 12, 2026, 8:36 a.m. UTC | #1
Hi Minwoo Choi,

On 5/11/26 11:34 AM, 최민우 via lists.yoctoproject.org wrote:
> [You don't often get email from mw.choi=telica.co.kr@lists.yoctoproject.org. Learn why this is important at https://aka.ms/LearnAboutSenderIdentification ]
> > Signed-off-by: Minwoo Choi <mw.choi@telica.co.kr>
> ---
>   documentation/ref-manual/variables.rst | 5 +++--
>   1 file changed, 3 insertions(+), 2 deletions(-)
> 
> diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
> index a8cbb87cf..755929947 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

Where do you see it is "commonly referred to as dynamic layers"? I 
cannot find it in the docs.

Cheers,
Quentin
Robert P. J. Day May 12, 2026, 9:55 a.m. UTC | #2
On Tue, 12 May 2026, Quentin Schulz via lists.yoctoproject.org wrote:

> Hi Minwoo Choi,
>
> On 5/11/26 11:34 AM, 최민우 via lists.yoctoproject.org wrote:
> > [You don't often get email from mw.choi=telica.co.kr@lists.yoctoproject.org.
> > Learn why this is important at https://aka.ms/LearnAboutSenderIdentification
> > ]
> > > Signed-off-by: Minwoo Choi <mw.choi@telica.co.kr>
> > ---
> >   documentation/ref-manual/variables.rst | 5 +++--
> >   1 file changed, 3 insertions(+), 2 deletions(-)
> >
> > diff --git a/documentation/ref-manual/variables.rst
> > b/documentation/ref-manual/variables.rst
> > index a8cbb87cf..755929947 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
>
> Where do you see it is "commonly referred to as dynamic layers"? I cannot find
> it in the docs.

  Technically correct -- you won't find that phrase in the docs, but
that's how everyone *names* those directories. A small sample:

./meta-intel/dynamic-layers
./meta-ti/meta-ti-bsp/dynamic-layers
./meta-rockchip/dynamic-layers
./meta-raspberrypi/dynamic-layers
./meta-freescale/dynamic-layers
./meta-riscv/dynamic-layers
./meta-ros/meta-ros-common/dynamic-layers
./meta-virtualization/dynamic-layers
./meta-python-ai/dynamic-layers

  So there is certainly an *informal* convention.

rday
Yoann Congal May 12, 2026, 10:04 a.m. UTC | #3
On Mon May 11, 2026 at 11:34 AM CEST, 최민우 via lists.yoctoproject.org wrote:
> Signed-off-by: Minwoo Choi <mw.choi@telica.co.kr>

This fixes the bug #15713 – Document the "dynamic layer" concept
https://bugzilla.yoctoproject.org/show_bug.cgi?id=15713

Can you add "[YOCTO #15713]" in your commit message?

Thanks!

> ---
>  documentation/ref-manual/variables.rst | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
>
> diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
> index a8cbb87cf..755929947 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
Quentin Schulz May 12, 2026, 10:54 a.m. UTC | #4
Hi Robert, Minwoo Choi,

On 5/12/26 11:52 AM, Robert P. J. Day via lists.yoctoproject.org wrote:
> On Tue, 12 May 2026, Quentin Schulz via lists.yoctoproject.org wrote:
> 
>> Hi Minwoo Choi,
>>
>> On 5/11/26 11:34 AM, 최민우 via lists.yoctoproject.org wrote:
>>> [You don't often get email from mw.choi=telica.co.kr@lists.yoctoproject.org.
>>> Learn why this is important at https://aka.ms/LearnAboutSenderIdentification
>>> ]
>>>> Signed-off-by: Minwoo Choi <mw.choi@telica.co.kr>
>>> ---
>>>    documentation/ref-manual/variables.rst | 5 +++--
>>>    1 file changed, 3 insertions(+), 2 deletions(-)
>>>
>>> diff --git a/documentation/ref-manual/variables.rst
>>> b/documentation/ref-manual/variables.rst
>>> index a8cbb87cf..755929947 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
>>
>> Where do you see it is "commonly referred to as dynamic layers"? I cannot find
>> it in the docs.
> 
>    Technically correct -- you won't find that phrase in the docs, but
> that's how everyone *names* those directories. A small sample:
> 
> ./meta-intel/dynamic-layers
> ./meta-ti/meta-ti-bsp/dynamic-layers
> ./meta-rockchip/dynamic-layers
> ./meta-raspberrypi/dynamic-layers
> ./meta-freescale/dynamic-layers
> ./meta-riscv/dynamic-layers
> ./meta-ros/meta-ros-common/dynamic-layers
> ./meta-virtualization/dynamic-layers
> ./meta-python-ai/dynamic-layers
> 
>    So there is certainly an *informal* convention.
> 

OK, it'd be nice to mention this in the commit log then :)

If it really is that widespread (do we have other layers that have 
BBFILES_DYNAMIC that are NOT using "dynamic-layers" as directory for 
storing recipes/classes/conf files when a given layer is present?) then 
we should probably update our example in the same entry in the glossary 
to use that directory name as well.

Cheers,
Quentin
diff mbox series

Patch

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index a8cbb87cf..755929947 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