[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1011/8267] ref-manual: Edits to UPSTREAM_CHECK_* variables.

[Emmanuele Bassi <ebassi src gnome org>]

commit cd7f7871749283b5220161521b8bed8e3ef5b29a
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Tue Jun 7 15:28:26 2016 -0700

    ref-manual: Edits to UPSTREAM_CHECK_* variables.
    
    Fixes [YOCTO #9671]
    
    Applied some review comments to these three variables.
    Edits to be sure to qualify that the variables only to recipes
    who inherit the distrodata class.
    
    (From yocto-docs rev: 1b094b0567fa75d1c77da7ec04641d034f29272d)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-variables.xml |   43 +++++++++++++++++-----------
 1 files changed, 26 insertions(+), 17 deletions(-)
---
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 385dd7f..9965269 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -14312,55 +14312,64 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
-        <glossentry 
id='var-UPSTREAM_CHECK_GITTAGREGEX_pn'><glossterm>UPSTREAM_CHECK_GITTAGREGEX_pn</glossterm>
+        <glossentry id='var-UPSTREAM_CHECK_GITTAGREGEX'><glossterm>UPSTREAM_CHECK_GITTAGREGEX</glossterm>
             <info>
-               UPSTREAM_CHECK_GITTAGREGEX_pn[doc] = "Filters relevant Git tags when fetching source from an 
upstream Git repository."
+               UPSTREAM_CHECK_GITTAGREGEX[doc] = "Filters relevant Git tags when fetching source from an 
upstream Git repository."
             </info>
             <glossdef>
                 <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    When the OpenEmbedded build system fetches source code
-                    from an upstream Git repository, the build system uses
-                    Git tags to determine which upstream release version to
-                    fetch.
+                    For recipes inheriting the
+                    <link linkend='ref-classes-distrodata'><filename>distrodata</filename></link>
+                    class, the <filename>UPSTREAM_CHECK_GITTAGREGEX</filename>
+                    variable causes the OpenEmbedded build system to use Git
+                    tabs to determine which upstream release version to
+                    fetch when fetching source code from an upstream Git
+                    repository.
                     You can use this regular expression to filter only
                     relevant tags:
                     <literallayout class='monospaced'>
-     UPSTREAM_CHECK_GITTAGREGEX_pn-<replaceable>recipe</replaceable> = "git_tag_regex"
+     UPSTREAM_CHECK_GITTAGREGEX-<replaceable>recipe</replaceable> = "git_tag_regex"
                     </literallayout>
                 </para>
             </glossdef>
         </glossentry>
 
-        <glossentry id='var-UPSTREAM_CHECK_REGEX_pn'><glossterm>UPSTREAM_CHECK_REGEX_pn</glossterm>
+        <glossentry id='var-UPSTREAM_CHECK_REGEX'><glossterm>UPSTREAM_CHECK_REGEX</glossterm>
             <info>
-               UPSTREAM_CHECK_REGEX_pn[doc] = "The regular expression the package checking system uses to 
parse the page pointed to by UPSTREAM_CHECK_URI_pn."
+               UPSTREAM_CHECK_REGEX[doc] = "The regular expression the package checking system uses to parse 
the page pointed to by UPSTREAM_CHECK_URI_pn."
             </info>
             <glossdef>
                 <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    The regular expression used by the package checking system
-                    to parse the page found using
-                    <link 
linkend='var-UPSTREAM_CHECK_URI_pn'><filename>UPSTREAM_CHECK_URI_pn</filename></link>.
+                    For recipes inheriting the
+                    <link linkend='ref-classes-distrodata'><filename>distrodata</filename></link>
+                    class, the <filename>UPSTREAM_CHECK_REGEX</filename>
+                    variable causes the package checking system to use the
+                    regular expression to parse the page found using
+                    <link linkend='var-UPSTREAM_CHECK_URI'><filename>UPSTREAM_CHECK_URI</filename></link>.
                     <literallayout class='monospaced'>
-     UPSTREAM_CHECK_REGEX_pn-<replaceable>recipe</replaceable> = "package_regex"
+     UPSTREAM_CHECK_REGEX-<replaceable>recipe</replaceable> = "package_regex"
                     </literallayout>
                 </para>
             </glossdef>
         </glossentry>
 
-        <glossentry id='var-UPSTREAM_CHECK_URI_pn'><glossterm>UPSTREAM_CHECK_URI_pn</glossterm>
+        <glossentry id='var-UPSTREAM_CHECK_URI'><glossterm>UPSTREAM_CHECK_URI</glossterm>
             <info>
-               UPSTREAM_CHECK_URI_pn[doc] = "The URL used by the package checking system to get the latest 
version of the package when source files are fetched from an upstream Git repository."
+               UPSTREAM_CHECK_URI[doc] = "The URL used by the package checking system to get the latest 
version of the package when source files are fetched from an upstream Git repository."
             </info>
             <glossdef>
                 <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    The URL used by the package checking system to get the
+                    For recipes inheriting the
+                    <link linkend='ref-classes-distrodata'><filename>distrodata</filename></link>
+                    class, the <filename>UPSTREAM_CHECK_URI</filename>
+                    variable causes the package checking system to get the
                     latest version of the package when source files are
                     fetched from an upstream Git repository.
                     <literallayout class='monospaced'>
-     UPSTREAM_CHECK_URI_pn-<replaceable>recipe</replaceable> = "recipe_url"
+     UPSTREAM_CHECK_URI-<replaceable>recipe</replaceable> = "recipe_url"
                     </literallayout>
                 </para>
             </glossdef>