handbook: Various minor fixes

Signed-off-by: Richard Purdie <rpurdie@linux.intel.com>

1 files changed, 8 insertions, 8 deletions

diff --git a/handbook/ref-structure.xml b/handbook/ref-structure.xml
index 3d7c3c9db7..ca589de428 100644
--- a/handbook/ref-structure.xml
+++ b/handbook/ref-structure.xml
@@ -40,10 +40,10 @@
 
         <para>
             This directory contains user configuration files and the output 
-            from Poky. It's now deprecated to be a sub-directory in Poky source tree,
-            though it's still supported. The desired way is to use <link 
-            linkend='structure-core-script'>seperate output directory</link> for build
-            outside of Poky source tree.
+            generated by Poky in its standard configuration where the source tree is 
+            combined with the output. It is also possible to place output and configuration 
+            files in a directory separate from the Poky source, see the section <link 
+            linkend='structure-core-script'>seperate output directory</link>.
         </para>
     </section>
 
@@ -136,7 +136,7 @@
             a shell makes changes to PATH and sets other core BitBake variables based on the
             current working directory. You need to use this before running Poky commands.
             Internally it uses scripts within the <filename class="directory">scripts/ 
-            </filename> directory to do the bulk of the work. Now this script supports
+            </filename> directory to do the bulk of the work. This script supports
             specifying any directory as the build output:
         </para>
 
@@ -145,9 +145,9 @@ source POKY_SRC/poky-init-build-env [BUILDDIR]
         </programlisting>
 
         <para>
-            Above command can be typed from any directory, as long as POKY_SRC points to
+            The above command can be typed from any directory, as long as POKY_SRC points to
             the desired Poky source tree. The optional BUILDDIR could be any directory you'd
-            like to contain output contents.
+            like Poky to generate the build output into.
         </para>
     </section>
 </section>
@@ -182,7 +182,7 @@ source POKY_SRC/poky-init-build-env [BUILDDIR]
         <para>
             This file defines layers walked by bitbake. If there's no <filename>
             bblayers.conf</filename> present, it is created from <filename>bblayers.conf.sample
-            </filename>.
+            </filename> when the environment setup script is sourced.
         </para>
     </section>