[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1971/8267] ref-manual: Various small corrections to package-related stuff

[Emmanuele Bassi <ebassi src gnome org>]

commit feda248d593521726533796ad9c3e0e98cca47de
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Fri Aug 12 14:10:02 2016 -0700

    ref-manual: Various small corrections to package-related stuff
    
    Fixes [YOCTO #10135]
    
    Some small problems were fixed:
    
     * Added a cross-reference in the FILES glossary entry to the
       PACKAGES variable.  The two are tied and there was not a
       reference to it.
    
     * Removed a redundant "/" character in a pathname example in
       the dev-manual.
    
     * Removed a redundant "/" character in an example pathname
       in the FILES glossary description.
    
    (From yocto-docs rev: 11a397c232696deece7ac5c6dafcadb87d7a5775)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 .../dev-manual/dev-manual-common-tasks.xml         |    2 +-
 documentation/ref-manual/ref-variables.xml         |   10 +++++++---
 documentation/ref-manual/usingpoky.xml             |    2 +-
 3 files changed, 9 insertions(+), 5 deletions(-)
---
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml 
b/documentation/dev-manual/dev-manual-common-tasks.xml
index 9312d87..48d3ecb 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -3048,7 +3048,7 @@
 
      PV = "1.5.1+git${SRCPV}"
 
-     S = "${WORKDIR}/git/"
+     S = "${WORKDIR}/git"
 
      EXTRA_OEMAKE = "'CC=${CC}' 'RANLIB=${RANLIB}' 'AR=${AR}' 'CFLAGS=${CFLAGS} -I${S}/include 
-DWITHOUT_XATTR' 'BUILDDIR=${S}'"
 
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 7b1717c..ee1fcad 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4160,12 +4160,16 @@
 
         <glossentry id='var-FILES'><glossterm>FILES</glossterm>
             <info>
-                FILES[doc] = "The list of directories or files that are placed in packages."
+                FILES[doc] = "The list of directories or files that are placed in a package."
             </info>
             <glossdef>
                 <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    The list of directories or files that are placed in packages.
+                    The list of files and directories that are placed in a
+                    package.
+                    The
+                    <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>
+                    variable lists the packages generated by a recipe.
                 </para>
 
                 <para>
@@ -4176,7 +4180,7 @@
                     resulting package.
                     Here is an example:
                     <literallayout class='monospaced'>
-     FILES_${PN} += "${bindir}/mydir1/ ${bindir}/mydir2/myfile"
+     FILES_${PN} += "${bindir}/mydir1 ${bindir}/mydir2/myfile"
                     </literallayout>
                 </para>
 
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index 79322dd..5fac2b2 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -338,7 +338,7 @@
         <title>Running Specific Tasks</title>
 
         <para>
-            Any given package consists of a set of tasks.
+            Any given recipe consists of a set of tasks.
             The standard BitBake behavior in most cases is:
             <filename>do_fetch</filename>,
             <filename>do_unpack</filename>,