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. |