[gnome-continuous-yocto/gnomeostree-3.28-rocko: 7551/8267] ref-manual: Added review comments

[Emmanuele Bassi <ebassi src gnome org>]

commit 07ca1d57dc893a81da354239239901b987f2c603
Author: Kristi Rifenbark <kristi rifenbark gmail com>
Date:   Wed Aug 23 15:08:32 2017 -0700

    ref-manual: Added review comments
    
    Added review comments to variables COMPONENTS_DIR,
    and SYSROOT_DESTDIR. Added review comments to
    task do_prepare_recipe_sysroot.
    
    (From yocto-docs rev: 362998c71b44ddf89d32ed5c45e4251e932a9217)
    
    Signed-off-by: Kristi Rifenbark <kristi rifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-tasks.xml     |    5 +++--
 documentation/ref-manual/ref-variables.xml |    7 ++-----
 2 files changed, 5 insertions(+), 7 deletions(-)
---
diff --git a/documentation/ref-manual/ref-tasks.xml b/documentation/ref-manual/ref-tasks.xml
index 87ddb98..10c67ab 100644
--- a/documentation/ref-manual/ref-tasks.xml
+++ b/documentation/ref-manual/ref-tasks.xml
@@ -495,10 +495,11 @@
 
         <para>
             Installs the files into the individual recipe specific sysroots
-            (i.e.
+            (i.e. <filename>recipe-sysroot</filename> and
+            <filename>recipe-sysroot-native</filename> under
             <filename>${</filename><link 
linkend='var-WORKDIR'><filename>WORKDIR</filename></link><filename>}</filename>
             based upon the dependencies specified by
-            <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>.
+            <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>).
             See the
             "<link linkend='ref-classes-staging'><filename>staging</filename></link>"
             class for more information.
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 2b5f0e1..2c6ebca 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2224,7 +2224,7 @@
                 <para>
                     The default is
                     "<filename>${</filename><link 
linkend='var-STAGING_DIR'><filename>STAGING_DIR</filename></link><filename>}-components</filename>."
-                    (i.e. "<filename>${TMPDIR}/sysroots-components</filename>".
+                    (i.e. "<filename>${</filename><link 
linkend='var-TMPDIR'><filename>TMPDIR</filename></link><filename>}/sysroots-components</filename>").
                 </para>
             </glossdef>
         </glossentry>
@@ -13612,15 +13612,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
                     Points to the temporary directory under the work directory
                     (default
-                    <filename>${</filename><link 
linkend='var-WORKDIR'><filename>WORKDIR</filename></link><filename>}/sysroot-destidir</filename>)
+                    "<filename>${</filename><link 
linkend='var-WORKDIR'><filename>WORKDIR</filename></link><filename>}/sysroot-destdir</filename>")
                     where the files
                     that will be populated into the sysroot are assembled
                     during the
                     <link 
linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link>
                     task.
-                    <literallayout class='monospaced'>
-     SYSROOT_DESTDIR ?= "console=ttyS0,115200"
-                    </literallayout>
                 </para>
             </glossdef>
         </glossentry>