documentation: adt-manual - autotools-based projects

Fixes [YOCTO #2645]

In the section that describes how to build a toolchain using
bitbake meta-toolchain, I updated the note about the MACHINE
and SDKMACHINE variables.  These needed to be pointed out
to the user as important variables for correct settings
before generating the toolchain.

I added a new section for the autotools-based programs that
now includes a simple "Hello World" example.  This section
precedes the section that describes how to pass host options
to configure.sh.

(From yocto-docs rev: 9849e7b94d42a851f30f0fba8ae60916697956dd)

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

1 files changed, 12 insertions, 4 deletions

diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml
index 3fd231c6a0..040618482f 100644
--- a/documentation/adt-manual/adt-prepare.xml
+++ b/documentation/adt-manual/adt-prepare.xml
@@ -18,7 +18,7 @@
 
     <para>
         The following list describes installation methods that set up varying degrees of tool
-        availabiltiy on your system.
+        availability on your system.
         Regardless of the installation method you choose,
         you must <filename>source</filename> the cross-toolchain
         environment setup script before you use a toolchain.
@@ -258,9 +258,17 @@
                         <filename>bitbake meta-toolchain</filename>.</para>
                         <para>Use the appropriate <filename>bitbake</filename> command only after you have 
                         sourced the <filename>&OE_INIT_PATH;</filename> script located in the Source
-                        Directory.  
-                        When the <filename>bitbake</filename> command completes, the toolchain installer will 
-                        be in <filename>tmp/deploy/sdk</filename> in the Build Directory.
+                        Directory and you have made sure your <filename>conf/local.conf</filename>
+                        variables are correct.
+                        In particular, you need to be sure the
+                        <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
+                        variable matches the architecture for which you are building and that the 
+                        <filename>SDKMACHINE</filename> variable is correctly set if you are building 
+                        a toolchain for an architecture that differs from your current 
+                        development host machine.</para>
+                        <para>When the <filename>bitbake</filename> command completes, the 
+                        toolchain installer will be in <filename>tmp/deploy/sdk</filename> in the 
+                        Build Directory.
                         </para></note>
                     </para></listitem>
                 <listitem><para>Once you have the installer, run it to install the toolchain.