diff mbox series

overview-manual: mention idea of dynamic layers

Message ID 6032efe1-86e9-a83f-6247-939b7d3a36b8@crashcourse.ca
State New
Headers show
Series overview-manual: mention idea of dynamic layers | expand

Commit Message

Robert P. J. Day June 4, 2026, 3:59 p.m. UTC
Warn the reader that simply adding extra layer names to their
bblayers.conf file might have unintended consequences, and refer them
to the BBFILES_DYNAMIC variable for an explanation.

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

---
diff mbox series

Patch

diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index 76ace6fcf..a3893b52d 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -393,6 +393,13 @@  BitBake uses the ``conf/bblayers.conf`` file, which is part of the user
 configuration, to find what layers it should be using as part of the
 build.

+.. warning::
+
+   Even if your build doesn't need some of the layers listed in your
+   ``bblayers.conf`` file, the very inclusion of such layers might
+   affect your build based on the concept of *dynamic layers* as documented
+   by the :term:`BBFILES_DYNAMIC` variable.
+
 Distro Layer
 ~~~~~~~~~~~~