2 files changed, 12 insertions, 7 deletions

diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml
index e2eb2afe97..a2a439d01e 100644
--- a/documentation/adt-manual/adt-prepare.xml
+++ b/documentation/adt-manual/adt-prepare.xml
@@ -91,8 +91,8 @@
             <para>
                 If you use BitBake to generate the ADT Installer tarball, you must
                 <filename>source</filename> the environment setup script
-                (<ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>) 
-                located in the Source Directory before running the 
+                (<ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>)
+                located in the Source Directory before running the
                 BitBake command that creates the tarball.
             </para>
 
@@ -289,10 +289,12 @@
                         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>
+                        building and that the
+                        <ulink url='&YOCTO_DOCS_REF_URL;#var-SDKMACHINE'><filename>SDKMACHINE</filename></ulink>
                         variable is correctly set if you are building
-                        a toolchain for an architecture that differs from your
-                        current development host machine.</para>
+                        a toolchain designed to run on an architecture that
+                        differs from your current development host machine
+                        (i.e. the build machine).</para>
                         <para>When the BitBake command
                         completes, the toolchain installer will be in
                         <filename>tmp/deploy/sdk</filename> in the Build
diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml
index f17291f2cb..17f96b52ff 100644
--- a/documentation/ref-manual/technical-details.xml
+++ b/documentation/ref-manual/technical-details.xml
@@ -263,7 +263,8 @@
         The figure shows the commands you use to easily build out this
         toolchain.
         This cross-development toolchain is built to execute on the
-        <filename>SDKMACHINE</filename>, which might or might not be the same
+        <link linkend='var-SDKMACHINE'><filename>SDKMACHINE</filename></link>,
+        which might or might not be the same
         machine as the Build Host.
         <note>
             If your target architecture is supported by the Yocto Project,
@@ -320,7 +321,9 @@
                 </para></listitem>
             <listitem><para><filename>gcc-cross-canadian</filename>:
                 The final relocatable cross-compiler.
-                When run on the <filename>SDKMACHINE</filename>, this tool
+                When run on the
+                <link linkend='var-SDKMACHINE'><filename>SDKMACHINE</filename></link>,
+                this tool
                 produces executable code that runs on the target device.
                 </para></listitem>
         </itemizedlist>