ref-manual/ref-variables: add SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS

Removed some ambiguous text.

(From yocto-docs rev: cdf5cf7505af9c2c61e7b7d8a7db61ec0baad254)

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 28 insertions, 0 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 824f6962ee..600da575fc 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -3274,6 +3274,34 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS'><glossterm>SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS</glossterm>
+            <glossdef>
+                <para>
+                    A list of recipe dependencies that should not be used to 
+                    determine signatures of tasks from one recipe when they
+                    depend on tasks from another recipe. 
+                    For example:
+                    <literallayout class='monospaced'>
+    SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS += "intone->mplayer2"
+                    </literallayout>
+                    In this example, <filename>intone</filename> depends on 
+                    <filename>mplayer2</filename>.
+                </para>
+
+                <para>
+                    Use of this variable is one mechanism to remove dependencies 
+                    that affect task signatures and thus force rebuilds when a 
+                    recipe changes. 
+                    <caution>
+                        If you add an inappropriate dependency for a recipe
+                        relationship, the build might break when the interface
+                        of the second recipe changes after the first recipe has 
+                        been built.
+                    </caution>
+                </para>
+            </glossdef>
+        </glossentry>
+
         <glossentry id='var-SITEINFO_ENDIANNESS'><glossterm>SITEINFO_ENDIANNESS</glossterm>
             <glossdef>
                 <para>