From b490165ba1692d1b49c0e7d5c8ef21b6a07f9a70 Mon Sep 17 00:00:00 2001 From: "Robert P. J. Day" Date: Thu, 4 Jun 2026 13:11:09 -0400 Subject: [PATCH] overview-manual: update deploy.bbclass snippet The current contents of deploy.bbclass is slightly different so update the code snippet and the subsequent explanation of that snippet. (From yocto-docs rev: b5cfd275cdd620b5260c5e66e254363be795e798) Signed-off-by: Robert P. J. Day Signed-off-by: Antonin Godard (cherry picked from commit aec2a39ea648694bb5a30da216b721018e8bb670) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker --- documentation/overview-manual/concepts.rst | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index 37326d7a16..12c6b954f6 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst @@ -1828,7 +1828,8 @@ adding shared state wrapping to a task is as simple as this sstate_setscene(d) } addtask do_deploy_setscene - do_deploy[dirs] = "${DEPLOYDIR} ${B}" + do_deploy[dirs] = "${B}" + do_deploy[cleandirs] = "${DEPLOYDIR}" do_deploy[stamp-extra-info] = "${MACHINE_ARCH}" The following list explains the previous example: @@ -1873,9 +1874,16 @@ The following list explains the previous example: information, see the ":ref:`bitbake-user-manual/bitbake-user-manual-execution:setscene`" section in the BitBake User Manual. -- The ``do_deploy[dirs] = "${DEPLOYDIR} ${B}"`` line creates ``${DEPLOYDIR}`` - and ``${B}`` before the :ref:`ref-tasks-deploy` task runs, and also sets the - current working directory of :ref:`ref-tasks-deploy` to ``${B}``. For more +- The ``do_deploy[dirs] = "${B}"`` line creates the directory ``${B}`` + before the :ref:`ref-tasks-deploy` task runs, and also sets the + current working directory of :ref:`ref-tasks-deploy` to ``${B}``. + (If the directory already exists, it is left as is.) For more + information, see the ":ref:`bitbake-user-manual/bitbake-user-manual-metadata:variable flags`" + section in the BitBake User Manual. + +- The ``do_deploy[cleandirs] = "${DEPLOYDIR}"`` line creates the *empty* + directory ``${DEPLOYDIR}`` before the :ref:`ref-tasks-deploy` task runs. + (If the directory already exists, it is deleted and recreated empty.) For more information, see the ":ref:`bitbake-user-manual/bitbake-user-manual-metadata:variable flags`" section in the BitBake User Manual.