diff mbox series

ref-manual: document "RM_WORK_EXCLUDE_ITEMS" for rm_work.bbclass

Message ID eb6dc48a-f434-3167-ad28-d348ff1f4e77@crashcourse.ca
State New
Headers show
Series ref-manual: document "RM_WORK_EXCLUDE_ITEMS" for rm_work.bbclass | expand

Commit Message

Robert P. J. Day June 11, 2026, 10:34 a.m. UTC
Add an explanation of RM_WORK_EXCLUDE_ITEMS for rm_work.bbclass.

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

---
diff mbox series

Patch

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 95e07f85a..36b730823 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -2614,6 +2614,12 @@  which can also be set in your ``local.conf`` file. Here is an example::

    RM_WORK_EXCLUDE += "busybox glibc"

+Finally, if you are using this class for a recipe but want to prevent BitBake
+from deleting specific folders or files in that recipe's ``${WORKDIR}``
+(other than ``temp``), you can preserve those folders or files with::
+
+   RM_WORK_EXCLUDE_ITEMS += "stuff_to_keep"
+
 .. _ref-classes-rootfs*:

 ``rootfs*``