[PATCH] dev-manual: mention RM_WORK_EXCLUDE with inheriting rm_work

[PATCH] dev-manual: mention RM_WORK_EXCLUDE with inheriting rm_work

[rpjday]

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

---

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 1e6addde4..721b6c719 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -8986,6 +8986,12 @@
             </literallayout>
             Adding this statement deletes the work directory used for building
             a recipe once the recipe is built.
+            If "rm_work" is currently selected, you can override that cleaning
+            on a per-recipe basis (typically for debugging purposes) by adding a
+            line of this form to your <filename>local.conf</filename> file:
+            <literallayout class='monospaced'>
+     RM_WORK_EXCLUDE += "busybox"
+            </literallayout>
             For more information on "rm_work", see the
             <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-rm-work'><filename>rm_work</filename></ulink>
             class in the Yocto Project Reference Manual.

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                         http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

Re: [docs] [PATCH] dev-manual: mention RM_WORK_EXCLUDE with inheriting rm_work

[Quentin Schulz]

Hi Robert,

On Mon, Feb 17, 2020 at 08:12:35AM -0500, rpjday@crashcourse.ca wrote:
> 
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
> 
> ---
> 
> diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
> index 1e6addde4..721b6c719 100644
> --- a/documentation/dev-manual/dev-manual-common-tasks.xml
> +++ b/documentation/dev-manual/dev-manual-common-tasks.xml
> @@ -8986,6 +8986,12 @@
>              </literallayout>
>              Adding this statement deletes the work directory used for building
>              a recipe once the recipe is built.
> +            If "rm_work" is currently selected, you can override that cleaning
> +            on a per-recipe basis (typically for debugging purposes) by adding a
> +            line of this form to your <filename>local.conf</filename> file:
> +            <literallayout class='monospaced'>
> +     RM_WORK_EXCLUDE += "busybox"
> +            </literallayout>
>              For more information on "rm_work", see the
>              <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-rm-work'><filename>rm_work</filename></ulink>
>              class in the Yocto Project Reference Manual.
> 

RM_WORK_EXCLUDE is explained in the link provided just below your
change.
I'd think it's not needed to duplicate the information, especially
because we link to it?

Quentin

Re: [docs] [PATCH] dev-manual: mention RM_WORK_EXCLUDE with inheriting rm_work

[rpjday]

On Mon, 17 Feb 2020, Quentin Schulz wrote:

> Hi Robert,
>
> On Mon, Feb 17, 2020 at 08:12:35AM -0500, rpjday@crashcourse.ca wrote:
> >
> > Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
> >
> > ---
> >
> > diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
> > index 1e6addde4..721b6c719 100644
> > --- a/documentation/dev-manual/dev-manual-common-tasks.xml
> > +++ b/documentation/dev-manual/dev-manual-common-tasks.xml
> > @@ -8986,6 +8986,12 @@
> >              </literallayout>
> >              Adding this statement deletes the work directory used for building
> >              a recipe once the recipe is built.
> > +            If "rm_work" is currently selected, you can override that cleaning
> > +            on a per-recipe basis (typically for debugging purposes) by adding a
> > +            line of this form to your <filename>local.conf</filename> file:
> > +            <literallayout class='monospaced'>
> > +     RM_WORK_EXCLUDE += "busybox"
> > +            </literallayout>
> >              For more information on "rm_work", see the
> >              <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-rm-work'><filename>rm_work</filename></ulink>
> >              class in the Yocto Project Reference Manual.
> >
>
> RM_WORK_EXCLUDE is explained in the link provided just below your
> change. I'd think it's not needed to duplicate the information,
> especially because we link to it?

  fair enough.

rday