diff options
| author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2012-10-22 10:28:05 -0700 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2012-10-23 00:03:13 +0100 |
| commit | c26d20e7be7ffc1146f45fe50b35e63ed46b507d (patch) | |
| tree | 5891ed39e2f6877b47316237ffa0d82b639b54c1 /documentation/adt-manual/adt-prepare.xml | |
| parent | 3374926849eba0aab360ed23a45a630448928584 (diff) | |
| download | poky-c26d20e7be7ffc1146f45fe50b35e63ed46b507d.tar.gz | |
documentation: adt-manual - final edits before 1.3 lockdown.
Made some minor edits to the book before locking down the
files for 1.3.
(From yocto-docs rev: 2b941103585a31b5dbcb65b784cc3381467ed697)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/adt-manual/adt-prepare.xml')
| -rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index d660480b73..2e57e0cbe5 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml | |||
| @@ -52,7 +52,7 @@ | |||
| 52 | get any of the other mentioned benefits had you run the ADT Installer script.</para></listitem> | 52 | get any of the other mentioned benefits had you run the ADT Installer script.</para></listitem> |
| 53 | <listitem><para><emphasis>Use the Toolchain from within the Build Directory:</emphasis> | 53 | <listitem><para><emphasis>Use the Toolchain from within the Build Directory:</emphasis> |
| 54 | If you already have a | 54 | If you already have a |
| 55 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>, | 55 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>, |
| 56 | you can build the cross-toolchain within the directory. | 56 | you can build the cross-toolchain within the directory. |
| 57 | However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you | 57 | However, like the previous method mentioned, you only get the cross-toolchain and QEMU - you |
| 58 | do not get any of the other benefits without taking separate steps.</para></listitem> | 58 | do not get any of the other benefits without taking separate steps.</para></listitem> |
| @@ -77,21 +77,21 @@ | |||
| 77 | at | 77 | at |
| 78 | <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>. | 78 | <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>. |
| 79 | Or, you can use BitBake to generate the tarball inside the existing | 79 | Or, you can use BitBake to generate the tarball inside the existing |
| 80 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>. | 80 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. |
| 81 | </para> | 81 | </para> |
| 82 | 82 | ||
| 83 | <para> | 83 | <para> |
| 84 | If you use BitBake to generate the ADT Installer tarball, you must | 84 | If you use BitBake to generate the ADT Installer tarball, you must |
| 85 | <filename>source</filename> the environment setup script | 85 | <filename>source</filename> the environment setup script |
| 86 | (<filename>&OE_INIT_FILE;</filename>) located | 86 | (<filename>&OE_INIT_FILE;</filename>) located |
| 87 | in the source directory before running the <filename>bitbake</filename> | 87 | in the Source Directory before running the <filename>bitbake</filename> |
| 88 | command that creates the tarball. | 88 | command that creates the tarball. |
| 89 | </para> | 89 | </para> |
| 90 | 90 | ||
| 91 | <para> | 91 | <para> |
| 92 | The following example commands download the Poky tarball, set up the | 92 | The following example commands download the Poky tarball, set up the |
| 93 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink>, | 93 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>, |
| 94 | set up the environment while also creating the default build directory, | 94 | set up the environment while also creating the default Build Directory, |
| 95 | and run the <filename>bitbake</filename> command that results in the tarball | 95 | and run the <filename>bitbake</filename> command that results in the tarball |
| 96 | <filename>~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2</filename>: | 96 | <filename>~/yocto-project/build/tmp/deploy/sdk/adt_installer.tar.bz2</filename>: |
| 97 | <literallayout class='monospaced'> | 97 | <literallayout class='monospaced'> |
| @@ -251,7 +251,7 @@ | |||
| 251 | poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.sh | 251 | poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.sh |
| 252 | </literallayout> | 252 | </literallayout> |
| 253 | <note><para>As an alternative to steps one and two, you can build the toolchain installer | 253 | <note><para>As an alternative to steps one and two, you can build the toolchain installer |
| 254 | if you have a <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>. | 254 | if you have a <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. |
| 255 | If you need GMAE, you should use the <filename>bitbake meta-toolchain-gmae</filename> | 255 | If you need GMAE, you should use the <filename>bitbake meta-toolchain-gmae</filename> |
| 256 | command. | 256 | command. |
| 257 | The resulting installation script when run will support such development. | 257 | The resulting installation script when run will support such development. |
| @@ -259,10 +259,10 @@ | |||
| 259 | you can generate the toolchain installer using | 259 | you can generate the toolchain installer using |
| 260 | <filename>bitbake meta-toolchain</filename>.</para> | 260 | <filename>bitbake meta-toolchain</filename>.</para> |
| 261 | <para>Use the appropriate <filename>bitbake</filename> command only after you have | 261 | <para>Use the appropriate <filename>bitbake</filename> command only after you have |
| 262 | sourced the <filename>oe-build-init-env</filename> script located in the source | 262 | sourced the <filename>&OE_INIT_PATH;</filename> script located in the Source |
| 263 | directory. | 263 | Directory. |
| 264 | When the <filename>bitbake</filename> command completes, the toolchain installer will | 264 | When the <filename>bitbake</filename> command completes, the toolchain installer will |
| 265 | be in <filename>tmp/deploy/sdk</filename> in the build directory. | 265 | be in <filename>tmp/deploy/sdk</filename> in the Build Directory. |
| 266 | </para></note> | 266 | </para></note> |
| 267 | </para></listitem> | 267 | </para></listitem> |
| 268 | <listitem><para>Once you have the installer, run it to install the toolchain. | 268 | <listitem><para>Once you have the installer, run it to install the toolchain. |
| @@ -292,7 +292,7 @@ | |||
| 292 | <para> | 292 | <para> |
| 293 | A final way of making the cross-toolchain available is to use BitBake | 293 | A final way of making the cross-toolchain available is to use BitBake |
| 294 | to generate the toolchain within an existing | 294 | to generate the toolchain within an existing |
| 295 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>. | 295 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. |
| 296 | This method does not install the toolchain into the | 296 | This method does not install the toolchain into the |
| 297 | <filename>/opt</filename> directory. | 297 | <filename>/opt</filename> directory. |
| 298 | As with the previous method, if you need to install the target sysroot, you must | 298 | As with the previous method, if you need to install the target sysroot, you must |
| @@ -300,20 +300,20 @@ | |||
| 300 | </para> | 300 | </para> |
| 301 | 301 | ||
| 302 | <para> | 302 | <para> |
| 303 | Follow these steps to generate the toolchain into the build directory: | 303 | Follow these steps to generate the toolchain into the Build Directory: |
| 304 | <orderedlist> | 304 | <orderedlist> |
| 305 | <listitem><para>Source the environment setup script | 305 | <listitem><para>Source the environment setup script |
| 306 | <filename>&OE_INIT_FILE;</filename> located in the | 306 | <filename>&OE_INIT_FILE;</filename> located in the |
| 307 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink>. | 307 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>. |
| 308 | </para></listitem> | 308 | </para></listitem> |
| 309 | <listitem><para>At this point, you should be sure that the | 309 | <listitem><para>At this point, you should be sure that the |
| 310 | <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink> variable | 310 | <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink> variable |
| 311 | in the <filename>local.conf</filename> file found in the | 311 | in the <filename>local.conf</filename> file found in the |
| 312 | <filename>conf</filename> directory of the build directory | 312 | <filename>conf</filename> directory of the Build Directory |
| 313 | is set for the target architecture. | 313 | is set for the target architecture. |
| 314 | Comments within the <filename>local.conf</filename> file list the values you | 314 | Comments within the <filename>local.conf</filename> file list the values you |
| 315 | can use for the <filename>MACHINE</filename> variable. | 315 | can use for the <filename>MACHINE</filename> variable. |
| 316 | <note>You can populate the build directory with the cross-toolchains for more | 316 | <note>You can populate the Build Directory with the cross-toolchains for more |
| 317 | than a single architecture. | 317 | than a single architecture. |
| 318 | You just need to edit the <filename>MACHINE</filename> variable in the | 318 | You just need to edit the <filename>MACHINE</filename> variable in the |
| 319 | <filename>local.conf</filename> file and re-run the BitBake | 319 | <filename>local.conf</filename> file and re-run the BitBake |
| @@ -327,9 +327,9 @@ | |||
| 327 | after checking or editing the <filename>local.conf</filename> but without | 327 | after checking or editing the <filename>local.conf</filename> but without |
| 328 | changing out of your working directory.</note> | 328 | changing out of your working directory.</note> |
| 329 | Once the <filename>bitbake</filename> command finishes, | 329 | Once the <filename>bitbake</filename> command finishes, |
| 330 | the cross-toolchain is generated and populated within the build directory. | 330 | the cross-toolchain is generated and populated within the Build Directory. |
| 331 | You will notice environment setup files for the cross-toolchain in the | 331 | You will notice environment setup files for the cross-toolchain in the |
| 332 | build directory in the <filename>tmp</filename> directory. | 332 | Build Directory in the <filename>tmp</filename> directory. |
| 333 | Setup script filenames contain the strings <filename>environment-setup</filename>.</para> | 333 | Setup script filenames contain the strings <filename>environment-setup</filename>.</para> |
| 334 | <para>Be aware that when you use this method to install the toolchain you still need | 334 | <para>Be aware that when you use this method to install the toolchain you still need |
| 335 | to separately extract and install the sysroot filesystem. | 335 | to separately extract and install the sysroot filesystem. |
| @@ -351,9 +351,9 @@ | |||
| 351 | then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename> | 351 | then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename> |
| 352 | directory. | 352 | directory. |
| 353 | If you installed the toolchain in the | 353 | If you installed the toolchain in the |
| 354 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>, | 354 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>, |
| 355 | you can find the environment setup | 355 | you can find the environment setup |
| 356 | script for the toolchain in the build directory's <filename>tmp</filename> directory. | 356 | script for the toolchain in the Build Directory's <filename>tmp</filename> directory. |
| 357 | </para> | 357 | </para> |
| 358 | 358 | ||
| 359 | <para> | 359 | <para> |
| @@ -426,7 +426,7 @@ | |||
| 426 | you can do so one of two ways: | 426 | you can do so one of two ways: |
| 427 | <itemizedlist> | 427 | <itemizedlist> |
| 428 | <listitem><para>Modify the <filename>conf/local.conf</filename> configuration in | 428 | <listitem><para>Modify the <filename>conf/local.conf</filename> configuration in |
| 429 | the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink> | 429 | the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> |
| 430 | and then rebuild the image. | 430 | and then rebuild the image. |
| 431 | With this method, you need to modify the | 431 | With this method, you need to modify the |
| 432 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'><filename>EXTRA_IMAGE_FEATURES</filename></ulink> | 432 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'><filename>EXTRA_IMAGE_FEATURES</filename></ulink> |
