From 6ea2dd519a38757c56f452ea7f670dac743da9a8 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 12 Jun 2013 15:40:48 +0300 Subject: dev-manual: Updates to the term "Cross-Development Toolchain" (From yocto-docs rev: 80fcb3ce0a7d91dff2cb09dc5267528cfb6548ae) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-newbie.xml | 53 +++++++++++++++----------- 1 file changed, 31 insertions(+), 22 deletions(-) (limited to 'documentation/dev-manual/dev-manual-newbie.xml') 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 -- cgit v1.2.3-54-g00ecf