diff options
Diffstat (limited to 'documentation/adt-manual/adt-prepare.xml')
| -rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 48 |
1 files changed, 22 insertions, 26 deletions
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index 37d355e275..9880fcc7d1 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml @@ -1,5 +1,6 @@ <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" -"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" +[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > <chapter id='adt-prepare'> @@ -56,9 +57,9 @@ <para> The ADT Installer is contained in the ADT Installer tarball. You can download the tarball into any directory from the - <ulink url='http://downloads.yoctoproject.org/releases'>Index of Releases</ulink>, specifically + <ulink url='&YOCTO_DL_URL;/releases'>Index of Releases</ulink>, specifically at - <ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/adt_installer'></ulink>. + <ulink url='&YOCTO_ADTINSTALLER_DL_URL;'></ulink>. Or, you can use BitBake to generate the tarball inside the existing Yocto Project build tree. </para> @@ -81,9 +82,9 @@ $ cd ~ $ mkdir yocto-project $ cd yocto-project - $ wget http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/poky-edison-6.0.tar.bz2 - $ tar xjf poky-edison-6.0.tar.bz2 - $ source poky-edison-6.0/oe-init-build-env + $ wget &YOCTO_RELEASE_DL_URL;/&YOCTO_POKY_TARBALL; + $ tar xjf &YOCTO_POKY_TARBALL; + $ source &OE_INIT_PATH; $ bitbake adt-installer </literallayout> </para> @@ -173,11 +174,9 @@ <note> The ADT Installer requires the <filename>libtool</filename> package to complete. - If you install the recommended packages as described in the - "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#packages'>Packages</ulink>" - section of - <ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html'> - The Yocto Project Quick Start</ulink>, then you will have libtool installed. + If you install the recommended packages as described in + "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Packages</ulink>" + section of The Yocto Project Quick Start, then you will have libtool installed. </note> <para> @@ -191,7 +190,7 @@ <para> Once the installation completes, the ADT, which includes the cross-toolchain, is installed. You will notice environment setup files for the cross-toolchain in - <filename>/opt/poky/1.1</filename>, + <filename>&YOCTO_ADTPATH_DIR;</filename>, and image tarballs in the <filename>adt-installer</filename> directory according to your installer configurations, and the target sysroot located according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_<arch></filename> variable @@ -214,17 +213,17 @@ Follow these steps: <orderedlist> <listitem><para>Go to - <ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/toolchain'></ulink> + <ulink url='&YOCTO_TOOLCHAIN_DL_URL;'></ulink> and find the folder that matches your host development system (i.e. <filename>i686</filename> for 32-bit machines or - <filename>x86_64</filename> for 64-bit machines).</para></listitem> + <filename>x86-64</filename> for 64-bit machines).</para></listitem> <listitem><para>Go into that folder and download the toolchain tarball whose name includes the appropriate target architecture. For example, if your host development system is an Intel-based 64-bit system and you are going to use your cross-toolchain for an Intel-based 32-bit target, go into the <filename>x86_64</filename> folder and download the following tarball: <literallayout class='monospaced'> - poky-eglibc-x86_64-i586-toolchain-gmae-1.1.tar.bz2 + poky-eglibc-x86_64-i586-toolchain-gmae-&DISTRO;.tar.bz2 </literallayout> <note><para>As an alternative to steps one and two, you can build the toolchain tarball if you have a Yocto Project build tree. @@ -241,7 +240,7 @@ </para></note></para></listitem> <listitem><para>Make sure you are in the root directory with root privileges and then expand the tarball. - The tarball expands into <filename>/opt/poky/1.1</filename>. + The tarball expands into <filename>&YOCTO_ADTPATH_DIR;</filename>. Once the tarball is expanded, the cross-toolchain is installed. You will notice environment setup files for the cross-toolchain in the directory. </para></listitem> @@ -304,7 +303,7 @@ Before you can develop using the cross-toolchain, you need to set up the cross-development environment by sourcing the toolchain's environment setup script. If you used the ADT Installer or used an existing ADT tarball to install the ADT, - then you can find this script in the <filename>/opt/poky/1.1</filename> + then you can find this script in the <filename>&YOCTO_ADTPATH_DIR;</filename> directory. If you installed the toolchain in the build tree, you can find the environment setup script for the toolchain in the Yocto Project build tree's <filename>tmp</filename> directory. @@ -318,7 +317,7 @@ For example, the toolchain environment setup script for a 64-bit IA-based architecture would be the following: <literallayout class='monospaced'> - /opt/poky/1.1/environment-setup-x86_64-poky-linux + &YOCTO_ADTPATH_DIR;/environment-setup-x86_64-poky-linux </literallayout> </para> </section> @@ -340,10 +339,8 @@ To get the kernel and filesystem images, you either have to build them or download pre-built versions. You can find examples for both these situations in the - "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#test-run'>A - Quick Test Run</ulink>" section of - <ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html'> - The Yocto Project Quick Start</ulink>. + "<ulink url='&YOCTO_DOCS_QS_URL;#test-run'>A Quick Test Run</ulink>" section of + The Yocto Project Quick Start. </para> <para> @@ -352,12 +349,11 @@ <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) that you can use unaltered in the QEMU emulator. These kernel images reside in the Yocto Project release - area - <ulink url='http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/machines/'></ulink> + area - <ulink url='&YOCTO_MACHINES_DL_URL;'></ulink> and are ideal for experimentation within Yocto Project. For information on the image types you can build using the Yocto Project, see the - "<ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#ref-images'>Reference: Images</ulink>" appendix in - <ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html'> - The Yocto Project Reference Manual</ulink>. + "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Reference: Images</ulink>" appendix in + The Yocto Project Reference Manual. </para> <para> |