diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index e5d6f32419..ea0e05e363 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -567,8 +567,9 @@
Cross-Development Toolchain:
A collection of software development
- tools and utilities that allow you to develop software for
- targeted architectures.
+ tools and utilities that run on one architecture but
+ allow you to develop software for a different targeted
+ architecture.
This toolchain contains cross-compilers, linkers, and debuggers
that are specific to an architecture.
You can use the OpenEmbedded build system to build a
@@ -583,40 +584,48 @@
descriptions of each:
gcc-cross-initial:
- The initial compiler needed to bootstrap the toolchain
- that runs on the host and is used to build software
- for the target.
- This tool is a "native" package.
- gcc-cross-intermediate:
- The second stage of the bootstrap process that runs
- on the host and builds software for the target.
- This tool is a "native" package.
- gcc-cross:
- The the final stage of the bootstrap process that
- results in the cross compiler that runs on the host
+ The first stage of the bootstrap process that
+ results in the cross-compiler that runs on the host
and builds software for the target.
+ This tool is a "native" packages (i.e. it is
+ designed to run on the development host).
+
+ gcc-cross:
+ The second and final stage of the previously described
+ bootstrap process.
If you are replacing the cross compiler toolchain
- with a custom version, this is what you must replace.
- This tool is a "native" package.
+ with a custom version, you must replace
+ gcc-cross.
+ This tool is a "native" package (i.e. it is
+ designed to run on the development host).
+
gcc-runtime:
Runtime libraries from the toolchain bootstrapping
process.
This tool produces a binary for the target.
- gcc-crosssdk-initial/intermediate:
- Stage 1 and 2 of the a cross compiler that runs on the
- host and builds for the SDK.
+ gcc-crosssdk-initial:
+ The first stage of the Software Development Kit (SDK)
+ cross-compiler that runs on the host and builds for
+ the SDK.
Often the SDK is not the same target as the host.
This tool is a "native" binary.
gcc-crosssdk:
- The final stage of the SDK compiler.
+ The second and final stage of the previously mentioned
+ SDK cross-compiler.
This tool is a "native" binary.
The tool runs on the host and builds for the SDK.
gcc-cross-canadian:
- The compiler that runs on the SDK machine and is
- included with the SDK that builds software for the
- target.
+ A compiler built on one machine (build machine) that
+ runs on a different machine (host machine) and produces
+ software that runs on a third target machine.
+ See WikipediA's
+ Cross Compiler
+ page for a more general explanation of a
+ "Canadian Cross".
+ This compiler is included with the SDK that builds
+ software for the eventual target.
This tool is a "nativesdk" package.
Image: An image is the result produced when