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>

2 files changed, 11 insertions, 4 deletions

diff --git a/documentation/ref-manual/ref-tasks.xml b/documentation/ref-manual/ref-tasks.xml
index 66c219372a..e9859c1fa9 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 38d8605bb9..8824943acb 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>