[gnome-continuous-yocto/gnomeostree-3.28-rocko: 2974/8267] ref-manual: Review edits to do_populate_sysroot and SYSROOT_DIRS_NATIVE

[Emmanuele Bassi <ebassi src gnome org>]

commit cda7141ad131132024105922ddedbb0145b90e35
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Wed Oct 5 11:05:47 2016 -0700

    ref-manual: Review edits to do_populate_sysroot and SYSROOT_DIRS_NATIVE
    
    Fixes [YOCTO #10377]
    
    Some minor wordsmithing.  Also added a new note to the
    SYSROOT_DIRS_NATIVE variable.
    
    (From yocto-docs rev: 459666b01b8d6d8212a59c877ea6c324511a5883)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-tasks.xml     |    8 ++++----
 documentation/ref-manual/ref-variables.xml |    7 +++++++
 2 files changed, 11 insertions(+), 4 deletions(-)
---
diff --git a/documentation/ref-manual/ref-tasks.xml b/documentation/ref-manual/ref-tasks.xml
index 66c2193..e9859c1 100644
--- a/documentation/ref-manual/ref-tasks.xml
+++ b/documentation/ref-manual/ref-tasks.xml
@@ -463,10 +463,10 @@
             Stages (copies) a subset of the files installed by the
             <link linkend='ref-tasks-install'><filename>do_install</filename></link>
             task into the appropriate sysroot.
-            For information on how to make these files available to other
-            recipes, see the
-            <link linkend='var-STAGING_DIR_HOST'><filename>STAGING_DIR_HOST</filename></link>
-            variable.
+            For information on how to access these files from other recipes,
+            see the
+            <link linkend='var-STAGING_DIR_HOST'><filename>STAGING_DIR*</filename></link>
+            variables.
             Directories that would typically not be needed by other recipes at
             build time (e.g. <filename>/etc</filename>) are not copied by
             default.
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 38d8605..8824943 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -13210,6 +13210,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
          ${localstatedir} \
      "
                     </literallayout>
+                    <note>
+                        Programs built by <filename>-native</filename> recipes
+                        run directly from the sysroot
+                        (<filename>STAGING_DIR_NATIVE</filename>), which is
+                        why additional directories containing program
+                        executables and supporting files need to be staged.
+                    </note>
                 </para>
             </glossdef>
         </glossentry>