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