1 files changed, 19 insertions, 14 deletions

diff --git a/documentation/poky-ref-manual/ref-structure.xml b/documentation/poky-ref-manual/ref-structure.xml
index 0b8e7711c2..ea48299600 100644
--- a/documentation/poky-ref-manual/ref-structure.xml
+++ b/documentation/poky-ref-manual/ref-structure.xml
@@ -458,12 +458,15 @@
         <title><filename>build/tmp/work/</filename></title>
 
         <para>
-            This directory contains architecture-specific work sub-directories for packages built by BitBake.
-            All tasks execute from a work directory.
-            For example, the source for a particular package is unpacked, patched, configured and compiled all
-            within its own work directory.
-            Within the work directory, organization is based on the package group for which the source
-            is being compiled.
+            This directory contains architecture-specific work sub-directories
+            for packages built by BitBake.
+            All tasks execute from the appropriate work directory.
+            For example, the source for a particular package is unpacked,
+            patched, configured and compiled all within its own work directory.
+            Within the work directory, organization is based on the package group
+            and version for which the source is being compiled
+            as defined by the
+            <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>.
         </para>
 
         <para>
@@ -472,8 +475,9 @@
             on the machine <filename>qemux86</filename>
             built within the Yocto Project.
             For this package, a work directory of
-            <filename>tmp/work/qemux86-poky-linux/linux-yocto-3.0+git1+&lt;.....&gt;</filename>,
-            referred to as <filename><link linkend='var-WORKDIR'>WORKDIR</link></filename>, is created.
+            <filename>tmp/work/qemux86-poky-linux/linux-yocto/3.0+git1+&lt;.....&gt;</filename>,
+            referred to as the
+            <filename><link linkend='var-WORKDIR'>WORKDIR</link></filename>, is created.
             Within this directory, the source is unpacked to
             <filename>linux-qemux86-standard-build</filename> and then patched by Quilt
             (see the
@@ -486,13 +490,14 @@
         </para>
 
         <para>
-            There are other directories generated within WORKDIR.
-            The most important directory is WORKDIR<filename>/temp/</filename>, which has log files for each
-            task (<filename>log.do_*.pid</filename>) and contains the scripts BitBake runs for
-            each task (<filename>run.do_*.pid</filename>).
-            The WORKDIR<filename>/image/</filename> directory is where "make
+            There are other directories generated within <filename>WORKDIR</filename>.
+            The most important directory is <filename>WORKDIR/temp/</filename>,
+            which has log files for each task (<filename>log.do_*.pid</filename>)
+            and contains the scripts BitBake runs for each task
+            (<filename>run.do_*.pid</filename>).
+            The <filename>WORKDIR/image/</filename> directory is where "make
             install" places its output that is then split into sub-packages
-            within WORKDIR<filename>/packages-split/</filename>.
+            within <filename>WORKDIR/packages-split/</filename>.
         </para>
     </section>
 </section>