[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1966/8267] ref-manual: Updated PROVIDES and FILES variable descriptions

[Emmanuele Bassi <ebassi src gnome org>]

commit 72ebd628216be2c3e249b43baa603b653301108e
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Aug 8 09:21:20 2016 -0700

    ref-manual: Updated PROVIDES and FILES variable descriptions
    
    Fixes [YOCTO #10094]
    
    For PROVIDES, I added information about how the do_package
    task goes through PACKAGES and uses the FILES variable
    corresponding to each package to assign files to the package.
    
    For FILES, I added a blurb to the existing note how you can
    find default values for the FILES* variables.
    
    (From yocto-docs rev: c70f79a608076c5c0490918b87986554bc5d8353)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-variables.xml |   16 +++++++++++++++-
 1 files changed, 15 insertions(+), 1 deletions(-)
---
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index d7902ca..7b1717c 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4191,6 +4191,8 @@
                     You can find a list of these variables at the top of the
                     <filename>meta/conf/bitbake.conf</filename> file in the
                     <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
+                    You will also find the default values of the various
+                    <filename>FILES_*</filename> variables in this file.
                 </note>
 
                 <para>
@@ -4205,7 +4207,6 @@
                     variable for information on how to identify these files to
                     the PMS.
                 </para>
-
             </glossdef>
         </glossentry>
 
@@ -9181,6 +9182,19 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
      ${PN}-dbg ${PN}-staticdev ${PN}-dev ${PN}-doc ${PN}-locale ${PACKAGE_BEFORE_PN} ${PN}
                     </literallayout>
                 </para>
+
+                <para>
+                    During packaging, the
+                    <link linkend='ref-tasks-package'><filename>do_package</filename></link>
+                    task goes through <filename>PACKAGES</filename> and uses
+                    the
+                    <link linkend='var-FILES'><filename>FILES</filename></link>
+                    variable corresponding to each package to assign files to
+                    the package.
+                    If a file matches the <filename>FILES</filename> variable
+                    for more than one package in <filename>PACKAGES</filename>,
+                    it will be assigned to the earliest (leftmost) package.
+                </para>
             </glossdef>
         </glossentry>