diff options
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/dev-manual/dev-manual-newbie.xml | 53 |
1 files changed, 31 insertions, 22 deletions
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 @@ | |||
| 567 | <listitem><para id='cross-development-toolchain'> | 567 | <listitem><para id='cross-development-toolchain'> |
| 568 | <emphasis>Cross-Development Toolchain:</emphasis> | 568 | <emphasis>Cross-Development Toolchain:</emphasis> |
| 569 | A collection of software development | 569 | A collection of software development |
| 570 | tools and utilities that allow you to develop software for | 570 | tools and utilities that run on one architecture but |
| 571 | targeted architectures. | 571 | allow you to develop software for a different targeted |
| 572 | architecture. | ||
| 572 | This toolchain contains cross-compilers, linkers, and debuggers | 573 | This toolchain contains cross-compilers, linkers, and debuggers |
| 573 | that are specific to an architecture. | 574 | that are specific to an architecture. |
| 574 | You can use the OpenEmbedded build system to build a | 575 | You can use the OpenEmbedded build system to build a |
| @@ -583,40 +584,48 @@ | |||
| 583 | descriptions of each: | 584 | descriptions of each: |
| 584 | <itemizedlist> | 585 | <itemizedlist> |
| 585 | <listitem><para><filename>gcc-cross-initial</filename>: | 586 | <listitem><para><filename>gcc-cross-initial</filename>: |
| 586 | The initial compiler needed to bootstrap the toolchain | 587 | The first stage of the bootstrap process that |
| 587 | that runs on the host and is used to build software | 588 | results in the cross-compiler that runs on the host |
| 588 | for the target. | ||
| 589 | This tool is a "native" package.</para></listitem> | ||
| 590 | <listitem><para><filename>gcc-cross-intermediate</filename>: | ||
| 591 | The second stage of the bootstrap process that runs | ||
| 592 | on the host and builds software for the target. | ||
| 593 | This tool is a "native" package.</para></listitem> | ||
| 594 | <listitem><para><filename>gcc-cross</filename>: | ||
| 595 | The the final stage of the bootstrap process that | ||
| 596 | results in the cross compiler that runs on the host | ||
| 597 | and builds software for the target. | 589 | and builds software for the target. |
| 590 | This tool is a "native" packages (i.e. it is | ||
| 591 | designed to run on the development host). | ||
| 592 | </para></listitem> | ||
| 593 | <listitem><para><filename>gcc-cross</filename>: | ||
| 594 | The second and final stage of the previously described | ||
| 595 | bootstrap process. | ||
| 598 | If you are replacing the cross compiler toolchain | 596 | If you are replacing the cross compiler toolchain |
| 599 | with a custom version, this is what you must replace. | 597 | with a custom version, you must replace |
| 600 | This tool is a "native" package.</para></listitem> | 598 | <filename>gcc-cross</filename>. |
| 599 | This tool is a "native" package (i.e. it is | ||
| 600 | designed to run on the development host). | ||
| 601 | </para></listitem> | ||
| 601 | <listitem><para><filename>gcc-runtime</filename>: | 602 | <listitem><para><filename>gcc-runtime</filename>: |
| 602 | Runtime libraries from the toolchain bootstrapping | 603 | Runtime libraries from the toolchain bootstrapping |
| 603 | process. | 604 | process. |
| 604 | This tool produces a binary for the target. | 605 | This tool produces a binary for the target. |
| 605 | </para></listitem> | 606 | </para></listitem> |
| 606 | <listitem><para><filename>gcc-crosssdk-initial/intermediate</filename>: | 607 | <listitem><para><filename>gcc-crosssdk-initial</filename>: |
| 607 | Stage 1 and 2 of the a cross compiler that runs on the | 608 | The first stage of the Software Development Kit (SDK) |
| 608 | host and builds for the SDK. | 609 | cross-compiler that runs on the host and builds for |
| 610 | the SDK. | ||
| 609 | Often the SDK is not the same target as the host. | 611 | Often the SDK is not the same target as the host. |
| 610 | This tool is a "native" binary.</para></listitem> | 612 | This tool is a "native" binary.</para></listitem> |
| 611 | <listitem><para><filename>gcc-crosssdk</filename>: | 613 | <listitem><para><filename>gcc-crosssdk</filename>: |
| 612 | The final stage of the SDK compiler. | 614 | The second and final stage of the previously mentioned |
| 615 | SDK cross-compiler. | ||
| 613 | This tool is a "native" binary. | 616 | This tool is a "native" binary. |
| 614 | The tool runs on the host and builds for the SDK. | 617 | The tool runs on the host and builds for the SDK. |
| 615 | </para></listitem> | 618 | </para></listitem> |
| 616 | <listitem><para><filename>gcc-cross-canadian</filename>: | 619 | <listitem><para><filename>gcc-cross-canadian</filename>: |
| 617 | The compiler that runs on the SDK machine and is | 620 | A compiler built on one machine (build machine) that |
| 618 | included with the SDK that builds software for the | 621 | runs on a different machine (host machine) and produces |
| 619 | target. | 622 | software that runs on a third target machine. |
| 623 | See WikipediA's | ||
| 624 | <ulink url='http://en.wikipedia.org/wiki/Cross_compiler#Canadian_Cross'>Cross Compiler</ulink> | ||
| 625 | page for a more general explanation of a | ||
| 626 | "Canadian Cross". | ||
| 627 | This compiler is included with the SDK that builds | ||
| 628 | software for the eventual target. | ||
| 620 | This tool is a "nativesdk" package.</para></listitem> | 629 | This tool is a "nativesdk" package.</para></listitem> |
| 621 | </itemizedlist></para></listitem> | 630 | </itemizedlist></para></listitem> |
| 622 | <listitem><para><emphasis>Image:</emphasis> An image is the result produced when | 631 | <listitem><para><emphasis>Image:</emphasis> An image is the result produced when |
