diff options
| author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2012-09-13 14:01:58 -0700 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2012-09-14 09:50:52 +0100 |
| commit | c4a923bcb0194c05b14d40be7ad4ecd193eb7a69 (patch) | |
| tree | 6bec21f8000bfb08a8405124b78cdbdc1c22b0b6 /documentation/dev-manual | |
| parent | 4c90692716feb5e52f7859e2013b02f6f6703062 (diff) | |
| download | poky-c4a923bcb0194c05b14d40be7ad4ecd193eb7a69.tar.gz | |
documentation: Toolchain corrections from tarball to .sh file
For 1.3 there is not longer a toolchain tarball. Instead, there
is a wrapper script that lets you install the tarball. This
fundamental usage model change caused several ripples throughout
the documentation set. I have changed wordings and examples
to reflect the new paradigm.
(From yocto-docs rev: afb2069daa91e04c0f78ba425a6b184cb820d888)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
| -rw-r--r-- | documentation/dev-manual/dev-manual-model.xml | 17 | ||||
| -rw-r--r-- | documentation/dev-manual/dev-manual-newbie.xml | 12 | ||||
| -rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 4 |
3 files changed, 20 insertions, 13 deletions
diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml index 5f3b67de24..4bdb91208c 100644 --- a/documentation/dev-manual/dev-manual-model.xml +++ b/documentation/dev-manual/dev-manual-model.xml | |||
| @@ -1066,10 +1066,17 @@ | |||
| 1066 | Developer's Guide for information on how to install the toolchain into the build | 1066 | Developer's Guide for information on how to install the toolchain into the build |
| 1067 | directory.</para></listitem> | 1067 | directory.</para></listitem> |
| 1068 | <listitem><para><emphasis>Specify the Sysroot Location:</emphasis> | 1068 | <listitem><para><emphasis>Specify the Sysroot Location:</emphasis> |
| 1069 | This location is where the root filesystem for the | 1069 | This location is where the root filesystem for the target hardware resides. |
| 1070 | target hardware is created on the development system by the ADT Installer. | 1070 | If you used the ADT Installer, then the location is |
| 1071 | The QEMU user-space tools, the | 1071 | <filename>/opt/poky/<release></filename>. |
| 1072 | NFS boot process, and the cross-toolchain all use the sysroot location. | 1072 | Additionally, when you use the ADT Installer, the same location is used for |
| 1073 | the QEMU user-space tools and the NFS boot process.</para> | ||
| 1074 | <para>If you used either of the other two methods to install the toolchain, then the | ||
| 1075 | location of the sysroot filesystem depends on where you separately | ||
| 1076 | extracted and intalled the filesystem.</para> | ||
| 1077 | <para>For information on how to install the toolchain and on how to extract | ||
| 1078 | and install the sysroot filesystem, see the | ||
| 1079 | "<ulink url='&YOCTO_DOCS_ADT_URL;#installing-the-adt'>Installing the ADT and Toolchains</ulink>" section. | ||
| 1073 | </para></listitem> | 1080 | </para></listitem> |
| 1074 | <listitem><para><emphasis>Select the Target Architecture:</emphasis> | 1081 | <listitem><para><emphasis>Select the Target Architecture:</emphasis> |
| 1075 | The target architecture is the type of hardware you are | 1082 | The target architecture is the type of hardware you are |
| @@ -1273,7 +1280,7 @@ directory.</para></listitem> | |||
| 1273 | <filename>New Connections</filename> Dialog.</para></listitem> | 1280 | <filename>New Connections</filename> Dialog.</para></listitem> |
| 1274 | <listitem><para>Use the drop-down menu now in the <filename>Connection</filename> field and pick | 1281 | <listitem><para>Use the drop-down menu now in the <filename>Connection</filename> field and pick |
| 1275 | the IP Address you entered.</para></listitem> | 1282 | the IP Address you entered.</para></listitem> |
| 1276 | <listitem><para>Click <filename>Debug</filename> to bring up a login screen | 1283 | <listitem><para>Click <filename>Run</filename> to bring up a login screen |
| 1277 | and login.</para></listitem> | 1284 | and login.</para></listitem> |
| 1278 | <listitem><para>Accept the debug perspective.</para></listitem> | 1285 | <listitem><para>Accept the debug perspective.</para></listitem> |
| 1279 | </orderedlist> | 1286 | </orderedlist> |
diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index 9a78d40bb2..3d1983e574 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml | |||
| @@ -170,7 +170,7 @@ | |||
| 170 | <listitem><para><anchor id='index-downloads' /><emphasis><ulink url='&YOCTO_DL_URL;/releases/'>Index of /releases:</ulink></emphasis> | 170 | <listitem><para><anchor id='index-downloads' /><emphasis><ulink url='&YOCTO_DL_URL;/releases/'>Index of /releases:</ulink></emphasis> |
| 171 | This area contains index releases such as | 171 | This area contains index releases such as |
| 172 | the <trademark class='trade'>Eclipse</trademark> | 172 | the <trademark class='trade'>Eclipse</trademark> |
| 173 | Yocto Plug-in, miscellaneous support, poky, pseudo, cross-development toolchains, | 173 | Yocto Plug-in, miscellaneous support, poky, pseudo, installers for cross-development toolchains, |
| 174 | and all released versions of Yocto Project in the form of images or tarballs. | 174 | and all released versions of Yocto Project in the form of images or tarballs. |
| 175 | Downloading and extracting these files does not produce a local copy of the | 175 | Downloading and extracting these files does not produce a local copy of the |
| 176 | Git repository but rather a snapshot of a particular release or image.</para> | 176 | Git repository but rather a snapshot of a particular release or image.</para> |
| @@ -283,11 +283,11 @@ | |||
| 283 | tools and utilities that allow you to develop software for targeted architectures. | 283 | tools and utilities that allow you to develop software for targeted architectures. |
| 284 | This toolchain contains cross-compilers, linkers, and debuggers that are specific to | 284 | This toolchain contains cross-compilers, linkers, and debuggers that are specific to |
| 285 | an architecture. | 285 | an architecture. |
| 286 | You can use the OpenEmbedded build system to build cross-development toolchains in tarball | 286 | You can use the OpenEmbedded build system to build a cross-development toolchain |
| 287 | form that, when | 287 | installer that when run installs the toolchain that contains the development tools you |
| 288 | unpacked, contain the development tools you need to cross-compile and test your software. | 288 | need to cross-compile and test your software. |
| 289 | The Yocto Project ships with images that contain toolchains for supported architectures | 289 | The Yocto Project ships with images that contain installers for |
| 290 | as well. | 290 | toolchains for supported architectures as well. |
| 291 | Sometimes this toolchain is referred to as the meta-toolchain.</para></listitem> | 291 | Sometimes this toolchain is referred to as the meta-toolchain.</para></listitem> |
| 292 | <listitem><para><emphasis>Image:</emphasis> An image is the result produced when | 292 | <listitem><para><emphasis>Image:</emphasis> An image is the result produced when |
| 293 | BitBake processes a given collection of recipes and related metadata. | 293 | BitBake processes a given collection of recipes and related metadata. |
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 3209cb29b7..6e204d85e0 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml | |||
| @@ -313,9 +313,9 @@ | |||
| 313 | Regardless of the type of image you are using, you need to download the pre-built kernel | 313 | Regardless of the type of image you are using, you need to download the pre-built kernel |
| 314 | that you will boot in the QEMU emulator and then download and extract the target root | 314 | that you will boot in the QEMU emulator and then download and extract the target root |
| 315 | filesystem for your target machine’s architecture. | 315 | filesystem for your target machine’s architecture. |
| 316 | You can get architecture-specific binaries and filesystem from | 316 | You can get architecture-specific binaries and filesystems from |
| 317 | <ulink url='&YOCTO_MACHINES_DL_URL;'>machines</ulink>. | 317 | <ulink url='&YOCTO_MACHINES_DL_URL;'>machines</ulink>. |
| 318 | You can get stand-alone toolchains from | 318 | You can get installation scripts for stand-alone toolchains from |
| 319 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'>toolchains</ulink>. | 319 | <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'>toolchains</ulink>. |
| 320 | Once you have all your files, you set up the environment to emulate the hardware | 320 | Once you have all your files, you set up the environment to emulate the hardware |
| 321 | by sourcing an environment setup script. | 321 | by sourcing an environment setup script. |
