From: Scott Rifenbark <srifenbark@gmail.com>
Date: Mon, 6 Jun 2016 20:48:01 +0000 (-0700)
Subject: ref-manual: Updated the INHIBIT_PACKAGE_STRIP variable
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=44f29bf89aed57178dd00d8123d85c4e181241bd;p=thirdparty%2Fopenembedded%2Fopenembedded-core-contrib.git

ref-manual: Updated the INHIBIT_PACKAGE_STRIP variable

Fixes [YOCTO #9553]

Added detail to this variable description.

(From yocto-docs rev: 35407b9db582ebc23be89a6f9bc7b0ad9ab90979)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 02527579438..e29f359af10 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -5976,7 +5976,19 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             <glossdef>
                 <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    If set to "1", causes the build to not strip binaries in resulting packages.
+                    If set to "1", causes the build to not strip binaries in
+                    resulting packages and prevents the
+                    <filename>-dbg</filename> package from containing the
+                    source files.
+                </para>
+
+                <para>
+                     By default, the OpenEmbedded build system strips
+                     binaries and puts the debugging symbols into
+                     <filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}-dbg</filename>.
+                     Consequently, you should not set
+                     <filename>INHIBIT_PACKAGE_STRIP</filename> when you plan
+                     to debug in general.
                 </para>
             </glossdef>
         </glossentry>