summaryrefslogtreecommitdiffstats
path: root/documentation/adt-manual/adt-prepare.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2012-10-22 10:28:05 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2012-10-23 00:03:13 +0100
commitc26d20e7be7ffc1146f45fe50b35e63ed46b507d (patch)
tree5891ed39e2f6877b47316237ffa0d82b639b54c1 /documentation/adt-manual/adt-prepare.xml
parent3374926849eba0aab360ed23a45a630448928584 (diff)
downloadpoky-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.xml38
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>