documentation/poky-ref-manual/ref-images.xml: Updated the list of images.

The list of images has grown.  I added all images reported in the
1.1_M2 build using the 'ls meta*/recipes*/images/*.bb' command.

(From yocto-docs rev: 62e12a71c73a5e3a20c6887d754a96eb9e754b48)

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

1 files changed, 142 insertions, 29 deletions

diff --git a/documentation/poky-ref-manual/ref-images.xml b/documentation/poky-ref-manual/ref-images.xml
index 7bfca2af41..646e441c17 100644
--- a/documentation/poky-ref-manual/ref-images.xml
+++ b/documentation/poky-ref-manual/ref-images.xml
@@ -5,12 +5,9 @@
     <title>Reference: Images</title>
 
     <para>
-        Poky has several standard images covering most people's standard needs. 
-        Use the following command to list the supported images:
-        <literallayout class='monospaced'>
-     $ ls meta*/recipes*/images/*.bb
-        </literallayout>
-        Images are listed below along with details of what they contain:
+        The Yocto Project build process supports several types of images to satisfy different needs.  
+        When you issue the <filename>bitbake</filename> command you provide a “top-level” recipe 
+        that essentially begins the build for the type of image you want.
     </para>
 
     <note>
@@ -25,66 +22,182 @@
         </literallayout>
     </note>
 
+    <para>
+        From within the <filename>poky</filename> Git repository use the following command to list 
+        the supported images:
+        <literallayout class='monospaced'>
+     $ ls meta*/recipes*/images/*.bb
+        </literallayout>
+        These recipes reside in the <filename>meta/recipes-core/images</filename>,
+        <filename>meta/recipes-extended/images</filename>, 
+        <filename>meta/recipes-graphics/images</filename>, and 
+        <filename>meta/recipes-sato/images</filename> directories of your local Yocto Project 
+        file structure (Git repository or extracted release tarball).  
+        Although the recipe names are somewhat explanatory, here is a list that describes them:
+    </para>
+
     <itemizedlist>
             <listitem>
                 <para>
-                    <emphasis>core-image-minimal</emphasis> - A small image just capable 
+                    <emphasis><filename>core-image-base</filename></emphasis> - A console-only image that fully 
+                    supports the target device hardware. 
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-core</filename></emphasis> - An X11 image with simple 
+                    applications such as terminal, editor, and file manager.
+                </para>
+            </listitem>
+            <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>core-image-base</emphasis> - A console-only image that fully 
-                    supports the target device hardware. 
+                    <emphasis><filename>core-image-minimal-dev</filename></emphasis> – A 
+                    <filename>core-image-minimal</filename> image suitable for 
+                    development work.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis>core-image-core</emphasis> - An X11 image with simple 
-                    applications such as terminal, editor, and file manager.
+                    <emphasis><filename>core-image-minimal-directdisk</filename></emphasis> – A 
+                    <filename>core-image-minimal</filename>  image that you can 
+                    copy directly to the disk of the target device.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis>core-image-sato</emphasis> - An X11 image with Sato theme and
-                    Pimlico applications. 
-                    The image also contains terminal, editor, and file manager.
+                    <emphasis><filename>core-image-minimal-initramfs</filename></emphasis> – 
+                    A <filename>core-image-minimal</filename> image that has the Minimal RAM-based 
+                    Initial Root Filesystem (<filename>initramfs</filename>) as part of the kernel, 
+                    which allows the system to find the first “init” program more efficiently.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis>core-image-sato-dev</emphasis> - An X11 image similar to 
-                    core-image-sato but
-                    also includes a native toolchain and libraries needed to build applications 
-                    on the device itself. The image also includes testing and profiling tools 
-                    as well as debug symbols.  This image was formerly core-image-sdk.
+                    <emphasis><filename>core-image-minimal-live</filename></emphasis> – A 
+                    <filename>core-image-minimal</filename> image you can run from a 
+                    USB device or CD as is.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis>core-image-lsb</emphasis> - An image suitable for implementations 
+                    <emphasis><filename>core-image-minimal-mtdutils</filename></emphasis> – A 
+                    <filename>core-image-minimal</filename> image that has support 
+                    for the Minimal MTD Utilities, which let the user interact with the 
+                    MTD subsystem in the kernel to perform operations on flash devices.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-basic</filename></emphasis> – A foundational 
+                    basic image without support 
+                    for X that can be reasonably used for customization.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-lsb</filename></emphasis> - A
+                    <filename>core-image-basic</filename> image suitable for implementations 
                     that conform to Linux Standard Base (LSB).
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis>meta-toolchain</emphasis> - This image generates a tarball 
-                    that contains a stand-alone toolchain that can be used externally to Poky. 
-                    The tarball is self-contained and unpacks to the 
-                    <filename class="directory">/opt/poky</filename> directory. 
-                    The tarball also contains a copy of QEMU and the scripts necessary to run 
-                    poky QEMU images.
+                    <emphasis><filename>core-image-lsb-dev</filename></emphasis> - A
+                    <filename>core-image-lsb</filename> image that is suitable for development work.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-lsb-live</filename></emphasis> - A
+                    <filename>core-image-lsb</filename> image that you run from a USB device or CD as is.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis>meta-toolchain-sdk</emphasis> - This image includes everything in 
-                    meta-toolchain but also includes development headers and libraries
-                    to form a complete standalone SDK. 
+                    <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'> 
                     External Development Using the Poky SDK</link> section for more information.
                 </para>
             </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-lsb-sdk-live</filename></emphasis> - A 
+                    <filename>core-image-lsb-sdk</filename> image with the ability to run the image
+                    from a USB device or CD as is.
+                </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 rich and animated
+                    graphical user interaces.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-sato</filename></emphasis> - An image with Sato support, 
+                    a mobile environment and visual style that works well with mobile devices.
+                    The image supports X11 with a Sato theme and Pimlico applications and also  
+                    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 
+                    the device itself. 
+                    The image also includes testing and profiling tools as well as debug symbols.  
+                    This image was formerly <filename>core-image-sdk</filename>.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-sato-directdisk</filename></emphasis> - A
+                    <filename>core-image-sato</filename> image that can be copied directly to the 
+                    disk of the target device.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-sato-live</filename></emphasis> - A
+                    <filename>core-image-sato</filename> image with the ability to run 
+                    from a USB device or CD as is.
+                </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. 
+                    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-sato-sdk-directdisk</filename></emphasis> - A
+                    <filename>core-image-sato-sdk</filename> image that can be copied directly to the 
+                    disk of the target device.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis><filename>core-image-sato-sdk-live</filename></emphasis> - A
+                    <filename>core-image-sato-sdk</filename> image that you can run  
+                    from a USB device or CD as is.
+                </para>
+            </listitem>
     </itemizedlist>
 </appendix>
 <!--