[gnome-continuous-yocto/gnomeostree-3.28-rocko: 7544/8267] ref-manual: Added tmp/sysroots-components task

[Emmanuele Bassi <ebassi src gnome org>]

commit 49bc3e3d3e258684a527899f137d7c81e5ca27c9
Author: Kristi Rifenbark <kristi rifenbark gmail com>
Date:   Fri Aug 18 09:36:20 2017 -0700

    ref-manual: Added tmp/sysroots-components task
    
    (From yocto-docs rev: ae635dfc2f53e026b597c1d2ca93ecaa9416417c)
    
    Signed-off-by: Kristi Rifenbark <kristi rifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-structure.xml |   19 +++++++++++++++++++
 1 files changed, 19 insertions(+), 0 deletions(-)
---
diff --git a/documentation/ref-manual/ref-structure.xml b/documentation/ref-manual/ref-structure.xml
index 86a3cd2..70dbea5 100644
--- a/documentation/ref-manual/ref-structure.xml
+++ b/documentation/ref-manual/ref-structure.xml
@@ -800,6 +800,25 @@
     </section>
 
     <section id='structure-build-tmp-sysroots'>
+        <title><filename>build/tmp/sysroots-components/</filename></title>
+
+        <para>
+            This directory is the location of the sysroot contents that the
+            task
+            <link 
linkend='ref-tasks-prepare_recipe_sysroot'><filename>do_prepare_recipe_sysroot</filename></link>
+            links or copies into the recipe-specific sysroot for each
+            recipe listed in
+            <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>.
+            Population of this directory is handled through shared state, while
+            the path is specified by the <filename>COMPONENTS_DIR</filename>
+            variable. Apart from a few unusual circumstances, handling of the
+            <filename>sysroots-components</filename> directory should be
+            automatic, and recipes should not directly reference
+            <filename>build/tmp/sysroots-components</filename>.
+        </para>
+    </section>
+
+    <section id='structure-build-tmp-sysroots'>
         <title><filename>build/tmp/sysroots/</filename></title>
 
         <para>