[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1008/8267] ref-manual: Updated the INHIBIT_PACKAGE_STRIP variable

[Emmanuele Bassi <ebassi src gnome org>]

commit 44f29bf89aed57178dd00d8123d85c4e181241bd
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Jun 6 13:48:01 2016 -0700

    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>

 documentation/ref-manual/ref-variables.xml |   14 +++++++++++++-
 1 files changed, 13 insertions(+), 1 deletions(-)
---
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 0252757..e29f359 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>