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

First pass at implementing the poky.ent variables.  Also, updates some
text for some of the images.

(From yocto-docs rev: f77669c55b789372f89028d888192bcf771a24d9)

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

documentation/poky-ref-manual/ref-images.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-images'>
     <title>Reference: Images</title>
@@ -45,7 +46,10 @@
         <listitem><para><emphasis><filename>core-image-minimal</filename>:</emphasis>
             A small image just capable of allowing a device to boot.</para></listitem>
         <listitem><para><emphasis><filename>core-image-minimal-dev</filename>:</emphasis>
-            A <filename>core-image-minimal</filename> image suitable for development work.
+            A <filename>core-image-minimal</filename> image suitable for development work
+            using the host.
+            The image includes headers and libraries you can use in a host development 
+            environment.
             </para></listitem>
         <listitem><para><emphasis><filename>core-image-minimal-initramfs</filename>:</emphasis>
             A <filename>core-image-minimal</filename> image that has the Minimal RAM-based 
@@ -64,13 +68,17 @@
             A <filename>core-image-basic</filename> image suitable for implementations 
             that conform to Linux Standard Base (LSB).</para></listitem>
         <listitem><para><emphasis><filename>core-image-lsb-dev</filename>:</emphasis>
-            A <filename>core-image-lsb</filename> image that is suitable for development work.
+            A <filename>core-image-lsb</filename> image that is suitable for development work
+            using the host.
+            The image includes headers and libraries you can use in a host development 
+            environment.
             </para></listitem>
         <listitem><para><emphasis><filename>core-image-lsb-sdk</filename>:</emphasis>
             A <filename>core-image-lsb</filename> that includes everything in meta-toolchain 
             but also includes development headers and libraries to form a complete standalone SDK.
-            See the <link linkend='platdev-appdev-external-sdk'> 
+            This image is suitable for development using the target. 
-            External Development Using the Poky SDK</link> section for more information.
+            See the "<link linkend='platdev-appdev-external-sdk'> 
+            External Development Using the Poky SDK</link>" section for more information.
             </para></listitem>
         <listitem><para><emphasis><filename>core-image-clutter</filename>:</emphasis>
             An image with support for the Open GL-based toolkit Clutter, which enables development of 
@@ -82,15 +90,16 @@
             contains terminal, editor, and file manager.</para></listitem>
         <listitem><para><emphasis><filename>core-image-sato-dev</filename>:</emphasis>
             A <filename>core-image-sato</filename> image suitable for development 
-            that also includes a native toolchain and libraries needed to build applications on 
+            using the host.
-            the device itself. 
+            The image includes libraries needed to build applications on the device itself, 
-            The image also includes testing and profiling tools as well as debug symbols.  
+            testing and profiling tools, and debug symbols.  
             This image was formerly <filename>core-image-sdk</filename>.</para></listitem>
         <listitem><para><emphasis><filename>core-image-sato-sdk</filename>:</emphasis>
             A <filename>core-image-sato</filename> image that includes everything in meta-toolchain. 
-            The image also includes development headers and libraries to form a complete standalone SDK. 
+            The image also includes development headers and libraries to form a complete standalone SDK
-            See the <link linkend='platdev-appdev-external-sdk'> 
+            and is suitable for development using the target. 
-            External Development Using the Poky SDK</link> section for more information.
+            See the "<link linkend='platdev-appdev-external-sdk'> 
+            External Development Using the Poky SDK</link>" section for more information.
             </para></listitem>
     </itemizedlist>