ref-manual: Added the build/tmp/work-shared directory.

Added a brief explanation of this temporary directory to the chapter
that presents the structure of the Source Directory.  The
explanation is based on Paul Eggleton's input.

(From yocto-docs rev: 688c36aec57bb283d03ffb7e1d9448563cb1496c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 14 insertions, 0 deletions

diff --git a/documentation/ref-manual/ref-structure.xml b/documentation/ref-manual/ref-structure.xml
index be292eb136..93cd45d456 100644
--- a/documentation/ref-manual/ref-structure.xml
+++ b/documentation/ref-manual/ref-structure.xml
@@ -762,6 +762,20 @@
             within <filename>WORKDIR/packages-split/</filename>.
         </para>
     </section>
+
+    <section id='structure-build-work-shared'>
+        <title><filename>build/tmp/work-shared/</filename></title>
+
+        <para>
+            For efficiency, the OpenEmbedded build system creates and uses
+            this directory to hold recipes that share a work directory with
+            other recipes.
+            In practice, this is only used for <filename>gcc</filename>
+            and its variants (e.g. <filename>gcc-cross</filename>,
+            <filename>libgcc</filename>, <filename>gcc-runtime</filename>,
+            and so forth).
+        </para>
+    </section>
 </section>
 
 <section id='structure-meta'>