[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1650/8267] ref-manual: Updated RDEPENDS variable description with note.

[Emmanuele Bassi <ebassi src gnome org>]

commit 04c611290c1574ea97c960363b15823c382b2b1f
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Jul 18 10:31:29 2016 -0700

    ref-manual: Updated RDEPENDS variable description with note.
    
    Fixes [YOCTO #9963]
    
    I created a new cautionary note to warn the user to use the correct
    operator "+=" rather than "=" so that they do not destroy $PN.
    
    (From yocto-docs rev: e6861ffe9400b1ee48cc46ccfc6e8d65efbbec8c)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-variables.xml |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)
---
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 7b1aef0..8650efa 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -10178,6 +10178,18 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     Thus, the <filename>RDEPENDS</filename> variable has the
                     <filename>${PN}-dev</filename> package name as part of the
                     variable.
+                    <note>
+                        <title>Caution</title>
+                        <filename>RDEPENDS_${PN}-dev</filename> includes
+                        <filename>${</filename><link 
linkend='var-PN'><filename>PN</filename></link><filename>}</filename>
+                        by default.
+                        This default is set in the BitBake configuration file
+                        (<filename>meta/conf/bitbake.conf</filename>).
+                        Be careful not to accidentally remove
+                        <filename>${PN}</filename> when modifying
+                        <filename>RDEPENDS_${PN}-dev</filename>.
+                        Use the "+=" operator rather than the "=" operator.
+                    </note>
                 </para>
 
                 <para>