diff mbox series

[v3] dev-manual: explain how to properly call "bitbake-layers"

Message ID 375b7fa3-83b2-72b6-899e-45de4b79c023@crashcourse.ca
State Under Review
Headers show
Series [v3] dev-manual: explain how to properly call "bitbake-layers" | expand

Commit Message

Robert P. J. Day June 9, 2026, 8:35 a.m. UTC 
Emphasize right away that calling "bitbake-layers" needs an
initialized build environment to work properly -- that does not seem
to be explained in that section.

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

---
diff mbox series

Patch

diff --git a/documentation/dev-manual/layers.rst b/documentation/dev-manual/layers.rst
index b8842012e..dab1d2316 100644
--- a/documentation/dev-manual/layers.rst
+++ b/documentation/dev-manual/layers.rst
@@ -11,6 +11,13 @@  see the
 ":ref:`overview-manual/yp-intro:the yocto project layer model`"
 section in the Yocto Project Overview and Concepts Manual.

+Note well that to properly call the ``bitbake-layers`` command explained
+below, you must first
+:ref:`initialize the build environment <dev-manual/start:Initializing the Build Environment>`
+using your project's environment setup script.
+Without an initialized environment, your shell would not
+know where to find the command or your build configuration.
+
 Creating Your Own Layer
 =======================