adt-manual, ref-manual: Review edits for xcross-toolchain additions.

Mark Hatle reviewed the section and I updated some things based
off his input.  A rewrite to the "Makefile-Based Projects" section
to get it technically correct.  Also, removed all SDKROOT
documentation from both the adt-manual and ref-manual.

Fixes [YOCTO #7133]

(From yocto-docs rev: dd785777834611d94868a3774f2eb21ffc081b1a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2015-01-23 15:38:31 -08:00
committed by Richard Purdie
parent 93052c9900
commit b876909269
3 changed files with 16 additions and 19 deletions

View File

@@ -210,19 +210,28 @@
<title>Makefile-Based Projects</title>
<para>
For Makefile-based projects, you make sure your
<filename>Makefile</filename> has statements that ensure proper
use of the cross-toolchain.
For example, the following statements inside a
<filename>Makefile</filename> ensure the C compiler, linker, flags
passed to the C compiler, and flags passed to the C++ compiler are
specifically defined for the build:
For Makefile-based projects, the cross-toolchain environment
variables established by running the cross-toolchain environment
setup script override any settings you might have in your
<filename>Makefile</filename>.
For example, if you had settings such as the following in your
<filename>Makefile</filename>, the environment variables defined
by the script would override them:
<literallayout class='monospaced'>
<ulink url='&YOCTO_DOCS_REF_URL;#var-CC'>CC</ulink>=arm-poky-linux-gnueabi-gcc
<ulink url='&YOCTO_DOCS_REF_URL;#var-LD'>LD</ulink>=arm-poky-linux-gnueabi-ld
<ulink url='&YOCTO_DOCS_REF_URL;#var-CFLAGS'>CFLAGS</ulink>=”${CFLAGS} --sysroot=&lt;sysroot-dir&gt;
<ulink url='&YOCTO_DOCS_REF_URL;#var-CXXFLAGS'>CXXFLAGS</ulink>=”${CXXFLAGS} --sysroot=&lt;sysroot-dir&gt;
</literallayout>
Consequently, you should not set variables like
<ulink url='&YOCTO_DOCS_REF_URL;#var-CC'><filename>CC</filename></ulink>
and
<ulink url='&YOCTO_DOCS_REF_URL;#var-LD'><filename>LD</filename></ulink>
in your <filename>Makefile</filename>.
For the list of variables set up by the cross-toolchain environment
setup script, see the
"<link linkend='setting-up-the-cross-development-environment'>Setting Up the Cross-Development Environment</link>"
section.
</para>
</section>