[PATCH] ref-manual: warn reader about confusing DEPLOYDIR and DEPLOY_DIR

"Robert P. J. Day" <[email protected]> Fri, 26 Jun 2026 12:28:57 -0400 (EDT)
Newsgroups org.yoctoproject.lists.docs
Message-ID <[email protected]>
Add a couple warnings about mistaking the variables DEPLOYDIR and
DEPLOY_DIR for one another.

Signed-off-by: Robert P. J. Day <[email protected]>

---

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index b4c6bc957..cd88a20e0 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -2276,6 +2276,11 @@ system and gives an overview of their function and contents.
       ":ref:`overview-manual/concepts:application development sdk`" sections all in the
       Yocto Project Overview and Concepts Manual.

+      .. warning::
+
+         Do not confuse this variable with the similarly-named
+         :term:`DEPLOYDIR` variable.
+
    :term:`DEPLOY_DIR_DEB`
       Points to the area that the OpenEmbedded build system uses to place
       Debian packages that are ready to be used outside of the build
@@ -2366,6 +2371,11 @@ system and gives an overview of their function and contents.
       them into :term:`DEPLOY_DIR_IMAGE`
       afterwards.

+      .. warning::
+
+         Do not confuse this variable with the similarly-named
+         :term:`DEPLOY_DIR` variable.
+
    :term:`DESCRIPTION`
       The package description used by package managers. If not set,
       :term:`DESCRIPTION` takes the value of the :term:`SUMMARY`