[PATCH] ref_manual: add "fragments" and "templates" directories to structure

[PATCH] ref_manual: add "fragments" and "templates" directories to structure

[Robert P. J. Day]

Add two new entries for the meta/conf/{fragments,templates}
directories to the structure of OE-Core metadata.

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---

  I didn't bother with the "multiconfig" directory since all it
contained was an empty default.conf file. So let's just go with these.

diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst
index ff84b250b..96f9c9f34 100644
--- a/documentation/ref-manual/structure.rst
+++ b/documentation/ref-manual/structure.rst
@@ -862,6 +862,25 @@ it is possible to extend that support to other SDK hosts by adding
 additional configuration files in this subdirectory within another
 layer.

+.. _structure-meta-conf-fragments:
+
+``meta/conf/fragments/``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+This directory contains a number of
+:term:`configuration fragments <Configuration Fragment>` ---
+top-level build configuration features that can be independently enabled
+and disabled using standard tooling.
+
+.. _structure-meta-conf-templates:
+
+``meta/conf/templates/``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+This directory contains default templates to be used as initial files
+such as ``local.conf``, ``bblayers.conf`` and other files when
+initializing a new Yocto Project build.
+
 .. _structure-meta-files:

 ``meta/files/``

Re: [docs] [PATCH] ref_manual: add "fragments" and "templates" directories to structure

[Quentin Schulz]

Hi Robert,

On 6/23/26 7:43 PM, Robert P. J. Day via lists.yoctoproject.org wrote:
> 
> Add two new entries for the meta/conf/{fragments,templates}
> directories to the structure of OE-Core metadata.
> 
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
> 
> ---
> 
>    I didn't bother with the "multiconfig" directory since all it
> contained was an empty default.conf file. So let's just go with these.
> 
> diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst
> index ff84b250b..96f9c9f34 100644
> --- a/documentation/ref-manual/structure.rst
> +++ b/documentation/ref-manual/structure.rst
> @@ -862,6 +862,25 @@ it is possible to extend that support to other SDK hosts by adding
>   additional configuration files in this subdirectory within another
>   layer.
> 
> +.. _structure-meta-conf-fragments:
> +
> +``meta/conf/fragments/``
> +~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +This directory contains a number of
> +:term:`configuration fragments <Configuration Fragment>` ---
> +top-level build configuration features that can be independently enabled
> +and disabled using standard tooling.
> +

What standard tooling?

> +.. _structure-meta-conf-templates:
> +
> +``meta/conf/templates/``
> +~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +This directory contains default templates to be used as initial files
> +such as ``local.conf``, ``bblayers.conf`` and other files when
> +initializing a new Yocto Project build.
> +

I wouldn't know what makes a template and what they can be used for, 
should we point at 
documentation/dev-manual/custom-template-configuration-directory.rst for 
example?

>   .. _structure-meta-files:
> 
>   ``meta/files/``
> 
> 
> 
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#9843): https://lists.yoctoproject.org/g/docs/message/9843
> Mute This Topic: https://lists.yoctoproject.org/mt/119945115/6293953
> Group Owner: docs+owner@lists.yoctoproject.org
> Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [quentin.schulz@cherry.de]
> -=-=-=-=-=-=-=-=-=-=-=-
> 

Re: [docs] [PATCH] ref_manual: add "fragments" and "templates" directories to structure

[Robert P. J. Day]

On Wed, 24 Jun 2026, Quentin Schulz wrote:

> Hi Robert,
>
> On 6/23/26 7:43 PM, Robert P. J. Day via lists.yoctoproject.org wrote:
> >
> > Add two new entries for the meta/conf/{fragments,templates}
> > directories to the structure of OE-Core metadata.
> >
> > Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
> >
> > ---
> >
> >    I didn't bother with the "multiconfig" directory since all it
> > contained was an empty default.conf file. So let's just go with these.
> >
> > diff --git a/documentation/ref-manual/structure.rst
> > b/documentation/ref-manual/structure.rst
> > index ff84b250b..96f9c9f34 100644
> > --- a/documentation/ref-manual/structure.rst
> > +++ b/documentation/ref-manual/structure.rst
> > @@ -862,6 +862,25 @@ it is possible to extend that support to other SDK
> > hosts by adding
> >   additional configuration files in this subdirectory within another
> >   layer.
> >
> > +.. _structure-meta-conf-fragments:
> > +
> > +``meta/conf/fragments/``
> > +~~~~~~~~~~~~~~~~~~~~~~~~
> > +
> > +This directory contains a number of
> > +:term:`configuration fragments <Configuration Fragment>` ---
> > +top-level build configuration features that can be independently enabled
> > +and disabled using standard tooling.
> > +
>
> What standard tooling?

  i simply copied the text verbatim from the opening sentence here:

https://docs.yoctoproject.org/dev-manual/creating-fragments.html

rday

Re: [docs] [PATCH] ref_manual: add "fragments" and "templates" directories to structure

[Antonin Godard]

Hi,

On Tue Jun 23, 2026 at 7:43 PM CEST, Robert P. J. Day wrote:
>
> Add two new entries for the meta/conf/{fragments,templates}
> directories to the structure of OE-Core metadata.
>
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
> ---
>
>   I didn't bother with the "multiconfig" directory since all it
> contained was an empty default.conf file. So let's just go with these.
>
> diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst
> index ff84b250b..96f9c9f34 100644
> --- a/documentation/ref-manual/structure.rst
> +++ b/documentation/ref-manual/structure.rst
> @@ -862,6 +862,25 @@ it is possible to extend that support to other SDK hosts by adding
>  additional configuration files in this subdirectory within another
>  layer.
>
> +.. _structure-meta-conf-fragments:
> +
> +``meta/conf/fragments/``
> +~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +This directory contains a number of
> +:term:`configuration fragments <Configuration Fragment>` ---
> +top-level build configuration features that can be independently enabled
> +and disabled using standard tooling.

s/using standard tooling/using the :bitbake_path:`bitbake-config-build <bin/bitbake-config-build>` utility/

Can you add a link to the reference manual's fragment section here please?
(documentation/ref-manual/fragments.rst)

> +
> +.. _structure-meta-conf-templates:
> +
> +``meta/conf/templates/``
> +~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +This directory contains default templates to be used as initial files
> +such as ``local.conf``, ``bblayers.conf`` and other files when
> +initializing a new Yocto Project build.

Please cross link to documentation/dev-manual/custom-template-configuration-directory.rst

Antonin

Re: [docs] [PATCH] ref_manual: add "fragments" and "templates" directories to structure

[Antonin Godard]

Hi,


On Thu Jun 25, 2026 at 10:23 AM CEST, Antonin Godard wrote:
> Hi,
>
> On Tue Jun 23, 2026 at 7:43 PM CEST, Robert P. J. Day wrote:
>>
>> Add two new entries for the meta/conf/{fragments,templates}
>> directories to the structure of OE-Core metadata.

Will you follow-up on this patch?

Antonin

Re: [docs] [PATCH] ref_manual: add "fragments" and "templates" directories to structure

[Robert P. J. Day]

On Thu, 2 Jul 2026, Antonin Godard wrote:

> Hi,
>
>
> On Thu Jun 25, 2026 at 10:23 AM CEST, Antonin Godard wrote:
> > Hi,
> >
> > On Tue Jun 23, 2026 at 7:43 PM CEST, Robert P. J. Day wrote:
> >>
> >> Add two new entries for the meta/conf/{fragments,templates}
> >> directories to the structure of OE-Core metadata.
>
> Will you follow-up on this patch?

  sorry, was there a request for a fix? not sure what you're asking
for here.

rday

Re: [docs] [PATCH] ref_manual: add "fragments" and "templates" directories to structure

[Antonin Godard]

On Thu Jul 2, 2026 at 10:40 AM CEST, Robert P. J. Day wrote:
> On Thu, 2 Jul 2026, Antonin Godard wrote:
>
>> Hi,
>>
>>
>> On Thu Jun 25, 2026 at 10:23 AM CEST, Antonin Godard wrote:
>> > Hi,
>> >
>> > On Tue Jun 23, 2026 at 7:43 PM CEST, Robert P. J. Day wrote:
>> >>
>> >> Add two new entries for the meta/conf/{fragments,templates}
>> >> directories to the structure of OE-Core metadata.
>>
>> Will you follow-up on this patch?
>
>   sorry, was there a request for a fix? not sure what you're asking
> for here.

I made comments on this patch, maybe you didn't see them:
https://lore.kernel.org/r/DJHZHPQ4OTHU.G3OFW0N2RNNB@bootlin.com

Antonin