documentation/poky-ref-manual/ref-structure.xml: 1.1.2 variables and updates

First pass at implementing the poky.ent variables.  Also updated minor
text changes.

(From yocto-docs rev: a72317d4ce7759d45320bd2b7142edb43c371578)

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

documentation/poky-ref-manual/ref-structure.xml

@@ -1,5 +1,6 @@
 <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
 
 <appendix id='ref-structure'>
 
@@ -14,10 +15,8 @@
 
 <para>
     For information on how to establish the Yocto Project files on your local development system, see the
-    <ulink url='http://www.yoctoproject.org/docs/1.1.1/dev-manual/dev-manual.html#getting-started'> 
+    "<ulink url='&YOCTO_DOCS_DEV_URL;#getting-setup'>Getting Set Up</ulink>"
-    Getting Setup</ulink> section in the 
+    section in the Yocto Project Development Manual.
-    <ulink url='http://www.yoctoproject.org/docs/1.1.1/dev-manual/dev-manual.html'>
-    The Yocto Project Development Manual</ulink>.
 </para>
 
 <section id='structure-core'>
@@ -35,7 +34,7 @@
             from BitBake itself.
             Consequently, most users do not need to worry about BitBake.
             The <filename>bitbake/bin/</filename> directory is placed 
-            into the <filename>PATH</filename> environment variable by the 
+            into the shell's <filename>PATH</filename> environment variable by the 
             <link linkend="structure-core-script">oe-init-build-env</link> script.
         </para>
 
@@ -121,7 +120,7 @@
             This directory contains various integration scripts that implement 
             extra functionality in the Yocto Project environment (e.g. QEMU scripts).
             The <link linkend="structure-core-script">oe-init-build-env</link> script appends this
-            directory to the <filename>PATH</filename> environment variable.
+            directory to the shell's <filename>PATH</filename> environment variable.
         </para>
 
         <para>
@@ -363,7 +362,7 @@
 
         <para>
             This directory contains intermediate packaging data that is used later in the packaging process. 
-            For more information, see <link linkend='ref-classes-package'>package.bbclass</link>.
+            For more information, see the "<link linkend='ref-classes-package'>Packaging - package*.bbclass</link>" section.
         </para>
     </section>
 
@@ -388,8 +387,8 @@
             referred to as <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 <link linkend="usingpoky-modifying-packages-quilt">Modifying Package Source Code
+            (see the "<link linkend="usingpoky-modifying-packages-quilt">Modifying Package Source Code
-            With Quilt</link> section).   
+            With Quilt</link>" section).   
             Within the <filename>linux-qemux86-standard-build</filename> directory, 
             standard Quilt directories <filename>linux-3.0/patches</filename>
             and <filename>linux-3.0/.pc</filename> are created,
@@ -480,8 +479,8 @@
         <title><filename>meta/recipes-bsp/</filename></title>
 
         <para>
-            This directory contains anything linking to specific hardware or hardware configuration information
+            This directory contains anything linking to specific hardware or hardware 
-            such as "u-boot" and "grub".
+            configuration information such as "u-boot" and "grub".
         </para>
     </section>