diff mbox series

ref_manual: add "fragments" and "templates" directories to structure

Message ID 21c2164f-ac8d-256d-f8ef-c15336fbba3e@crashcourse.ca
State New
Headers show
Series ref_manual: add "fragments" and "templates" directories to structure | expand

Commit Message

Robert P. J. Day June 23, 2026, 5:43 p.m. UTC
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 mbox series

Patch

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/``