diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2015-01-23 15:38:31 -0800 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2015-02-17 15:16:55 +0000 |
commit | b87690926928061c82f694dd923b15b3b60e40ae (patch) | |
tree | a37338af3e15534ce172e462dff90f2a0606673d /documentation/adt-manual | |
parent | 93052c9900da497fd4caa7dc8d214797446bb93b (diff) | |
download | openembedded-core-contrib-b87690926928061c82f694dd923b15b3b60e40ae.tar.gz |
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>
Diffstat (limited to 'documentation/adt-manual')
-rw-r--r-- | documentation/adt-manual/adt-command.xml | 23 | ||||
-rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 1 |
2 files changed, 16 insertions, 8 deletions
diff --git a/documentation/adt-manual/adt-command.xml b/documentation/adt-manual/adt-command.xml index 0faa05fa6c..d6fa8ee4d4 100644 --- a/documentation/adt-manual/adt-command.xml +++ b/documentation/adt-manual/adt-command.xml @@ -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=<sysroot-dir>” <ulink url='&YOCTO_DOCS_REF_URL;#var-CXXFLAGS'>CXXFLAGS</ulink>=”${CXXFLAGS} --sysroot=<sysroot-dir>” </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> diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index e75e9c95cd..260e1f18a0 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml @@ -423,7 +423,6 @@ When you run the setup script, many environment variables are defined: <literallayout class='monospaced'> - <ulink url='&YOCTO_DOCS_REF_URL;#var-SDKROOT'><filename>SDKROOT</filename></ulink> - The path to the installed SDK <ulink url='&YOCTO_DOCS_REF_URL;#var-SDKTARGETSYSROOT'><filename>SDKTARGETSYSROOT</filename></ulink> - The path to the sysroot used for cross-compilation <ulink url='&YOCTO_DOCS_REF_URL;#var-PKG_CONFIG_PATH'><filename>PKG_CONFIG_PATH</filename></ulink> - The path to the target pkg-config files <ulink url='&YOCTO_DOCS_REF_URL;#var-CONFIG_SITE'><filename>CONFIG_SITE</filename></ulink> - A GNU autoconf site file preconfigured for the target |