[PATCH] ref-manual: mention INHIBIT_PACKAGE_DEBUG_SPLIT variable

[PATCH] ref-manual: mention INHIBIT_PACKAGE_DEBUG_SPLIT variable

[Robert P. J. Day]

Following a detailed discussion of PACKAGE_DEBUG_SPLIT_STYLE, it seems
only appropriate to refer the reader to INHIBIT_PACKAGE_DEBUG_SPLIT.

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

---

  this patch is against master-next, as the earlier patch has not been
merged into master yet.

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 28eb5f233..6cb9ad9c9 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -5098,6 +5098,11 @@ system and gives an overview of their function and contents.
       -  "``debug-without-src``": The same behavior as with the ``.debug``
          setting, but no source is packaged at all.

+      .. note::
+
+         Much of the above package splitting can be overridden via
+         use of the :term:`INHIBIT_PACKAGE_DEBUG_SPLIT` variable.
+
       You can find out more about debugging using GDB by reading the
       ":ref:`dev-manual/common-tasks:debugging with the gnu project debugger (gdb) remotely`" section
       in the Yocto Project Development Tasks Manual.
-- 

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

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

Re: [docs] [PATCH] ref-manual: mention INHIBIT_PACKAGE_DEBUG_SPLIT variable

[Michael Opdenacker]

Hi Robert,

On 9/23/21 11:00 AM, Robert P. J. Day wrote:
> Following a detailed discussion of PACKAGE_DEBUG_SPLIT_STYLE, it seems
> only appropriate to refer the reader to INHIBIT_PACKAGE_DEBUG_SPLIT.
>
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
> ---
>
>   this patch is against master-next, as the earlier patch has not been
> merged into master yet.
>
> diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
> index 28eb5f233..6cb9ad9c9 100644
> --- a/documentation/ref-manual/variables.rst
> +++ b/documentation/ref-manual/variables.rst
> @@ -5098,6 +5098,11 @@ system and gives an overview of their function and contents.
>        -  "``debug-without-src``": The same behavior as with the ``.debug``
>           setting, but no source is packaged at all.
>
> +      .. note::
> +
> +         Much of the above package splitting can be overridden via
> +         use of the :term:`INHIBIT_PACKAGE_DEBUG_SPLIT` variable.
> +
>        You can find out more about debugging using GDB by reading the
>        ":ref:`dev-manual/common-tasks:debugging with the gnu project debugger (gdb) remotely`" section
>        in the Yocto Project Development Tasks Manual.

Thanks for the new patch.
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Merged in master-next.

Cheers,
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com