ref-manual, mega-manual: Updates to the SDK Generation section

Fixes [YOCTO #2808]

I updated the figure to not call out the SDK environment setup
script as it is part of the .sh file.  The figure was placed
in the "figures" directory of the ref-manual and the
mega-manual.

Also, I removed the duplicated variable descriptions and referenced
these descriptions in the "Application Development SDK" section,
which is further down in the manual.  The descriptions have more
to do with where output is placed.

(From yocto-docs rev: 256bb1447b571299b57c657bf030d5b4f033fb5f)

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

diff --git a/documentation/mega-manual/figures/sdk-generation.png b/documentation/mega-manual/figures/sdk-generation.png
index 9e7fd9a75d072c9d77ba7272df0355a511b31227..c37e2748ca7b18b7292f67e493768c933ad22480 100644 (file)
Binary files a/documentation/mega-manual/figures/sdk-generation.png and b/documentation/mega-manual/figures/sdk-generation.png differ

diff --git a/documentation/ref-manual/closer-look.xml b/documentation/ref-manual/closer-look.xml
index 0947340c07bafde336f964d89aed83a957d4f34a..eccf97698a82fa5c67ba1c2870bb0ea93208d1ba 100644 (file)
--- a/documentation/ref-manual/closer-look.xml
+++ b/documentation/ref-manual/closer-look.xml
@@ -981,8 +981,7 @@
 
             <para>
                 The OpenEmbedded build system uses BitBake to generate the
-                Software Development Kit (SDK) installer script and the
-                cross-development environment setup script:
+                Software Development Kit (SDK) installer script:
                 <imagedata fileref="figures/sdk-generation.png" align="center" width="6in" depth="7in" />
             </para>
 
@@ -998,36 +997,10 @@
                 several stages and depends on many variables.
                 The <filename>do_populate_sdk</filename> task uses these
                 key variables to help create the list of packages to actually
-                install:
-                <itemizedlist>
-                    <listitem><para><link linkend='var-DEPLOY_DIR'><filename>DEPLOY_DIR</filename></link>:
-                        Points to the <filename>deploy</filename>
-                        directory.</para></listitem>
-                    <listitem><para><link linkend='var-SDKMACHINE'><filename>SDKMACHINE</filename></link>:
-                        Specifies the architecture of the machine
-                        on which the cross-development tools are run to
-                        create packages for the target hardware.
-                        </para></listitem>
-                    <listitem><para><link linkend='var-SDKIMAGE_FEATURES'><filename>SDKIMAGE_FEATURES</filename></link>:
-                        Lists the features to include in the "target" part
-                        of the SDK.
-                        </para></listitem>
-                    <listitem><para><link linkend='var-TOOLCHAIN_HOST_TASK'><filename>TOOLCHAIN_HOST_TASK</filename></link>:
-                        Lists packages that make up the host
-                        part of the SDK (i.e. the part that runs on
-                        the <filename>SDKMACHINE</filename>).
-                        When you use
-                        <filename>bitbake -c populate_sdk &lt;imagename&gt;</filename>
-                        to create the SDK, a set of default packages
-                        apply.
-                        This variable allows you to add more packages.
-                        </para></listitem>
-                    <listitem><para><link linkend='var-TOOLCHAIN_TARGET_TASK'><filename>TOOLCHAIN_TARGET_TASK</filename></link>:
-                        Lists packages that make up the target part
-                        of the SDK (i.e. the part built for the
-                        target hardware).
-                        </para></listitem>
-                </itemizedlist>
+                install.
+                For information on the variables listed in the figure, see the
+                "<link linkend='sdk-dev-environment'>Application Development SDK</link>"
+                section.
             </para>
 
             <para>
@@ -1050,8 +1023,8 @@
 
             <para>
                 The final output of the task is the Cross-development
-                toolchain installation script (<filename>.sh</filename> file)
-                and the environment setup script.
+                toolchain installation script (<filename>.sh</filename> file),
+                which includes the environment setup script.
             </para>
         </section>
     </section>

diff --git a/documentation/ref-manual/figures/sdk-generation.png b/documentation/ref-manual/figures/sdk-generation.png
index 9e7fd9a75d072c9d77ba7272df0355a511b31227..c37e2748ca7b18b7292f67e493768c933ad22480 100644 (file)
Binary files a/documentation/ref-manual/figures/sdk-generation.png and b/documentation/ref-manual/figures/sdk-generation.png differ