sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

documentation/adt-manual: Converted manual to use the poky.ent file 

Conversion of hard links to use the variables set up in the file
documentation/poky.ent.

(From yocto-docs rev: edbacc1b57f02c31ff6eaee666245be83fb17543)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2012-03-06 17:06:44 -06:00 committed by Richard Purdie
parent eebdda725b
commit 2ede6c8c44
6 changed files with 46 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
documentation/adt-manual/adt-command.xml
View File

@ -1,5 +1,6 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!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='using-the-command-line'> <chapter id='using-the-command-line'>
<title>Using the Command Line</title> <title>Using the Command Line</title>

23
documentation/adt-manual/adt-eclipse.xml
View File

@ -1,5 +1,6 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!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-eclipse'> <chapter id='adt-eclipse'>
<title>Working Within Eclipse</title> <title>Working Within Eclipse</title>
@ -43,7 +44,7 @@
It is recommended that you have the Indigo 3.7 version of the It is recommended that you have the Indigo 3.7 version of the
Eclipse IDE installed on your development system. Eclipse IDE installed on your development system.
If you don’t have this version, you can find it at If you don’t have this version, you can find it at
<ulink url='http://www.eclipse.org/downloads'></ulink>. <ulink url='&ECLIPSE_MAIN_URL;'></ulink>.
From that site, choose the Eclipse Classic version particular to your development From that site, choose the Eclipse Classic version particular to your development
host. host.
This version contains the Eclipse Platform, the Java Development This version contains the Eclipse Platform, the Java Development
@ -100,7 +101,7 @@
<listitem><para>Make sure you are in your Workbench and select <listitem><para>Make sure you are in your Workbench and select
"Install New Software" from the "Help" pull-down menu. "Install New Software" from the "Help" pull-down menu.
</para></listitem> </para></listitem>
<listitem><para>Select <filename>indigo - http://download.eclipse.org/releases/indigo</filename> <listitem><para>Select <filename>indigo - &ECLIPSE_INDIGO_URL;</filename>
from the "Work with:" pull-down menu.</para></listitem> from the "Work with:" pull-down menu.</para></listitem>
<listitem><para>Expand the box next to <filename>Programming Languages</filename> <listitem><para>Expand the box next to <filename>Programming Languages</filename>
and select the <filename>Autotools Support for CDT (incubation)</filename> and select the <filename>Autotools Support for CDT (incubation)</filename>
@ -111,9 +112,9 @@
<listitem><para>Click the <listitem><para>Click the
"Available Software Sites" link.</para></listitem> "Available Software Sites" link.</para></listitem>
<listitem><para>Check the box next to <listitem><para>Check the box next to
<filename>http://download.eclipse.org/tm/updates/3.3</filename> <filename>&ECLIPSE_UPDATES_URL;</filename>
and click "OK".</para></listitem> and click "OK".</para></listitem>
<listitem><para>Select <filename>http://download.eclipse.org/tm/updates/3.3</filename> <listitem><para>Select <filename>&ECLIPSE_UPDATES_URL;</filename>
from the "Work with:" pull-down menu.</para></listitem> from the "Work with:" pull-down menu.</para></listitem>
<listitem><para>Check the box next to <filename>TM and RSE Main Features</filename>. <listitem><para>Check the box next to <filename>TM and RSE Main Features</filename>.
</para></listitem> </para></listitem>
@ -127,7 +128,7 @@
<listitem><para>After clicking "Available Software Sites", check the box next to <listitem><para>After clicking "Available Software Sites", check the box next to
<filename>http://download.eclipse.org/tools/cdt/releases/indigo</filename> <filename>http://download.eclipse.org/tools/cdt/releases/indigo</filename>
and click "OK".</para></listitem> and click "OK".</para></listitem>
<listitem><para>Select <filename>http://download.eclipse.org/tools/cdt/releases/indigo</filename> <listitem><para>Select <filename>&ECLIPSE_INDIGO_CDT_URL;</filename>
from the "Work with:" pull-down menu.</para></listitem> from the "Work with:" pull-down menu.</para></listitem>
<listitem><para>Check the box next to <filename>CDT Main Features</filename>. <listitem><para>Check the box next to <filename>CDT Main Features</filename>.
</para></listitem> </para></listitem>
@ -162,7 +163,7 @@
<listitem><para>In Eclipse, select "Install New Software" from the "Help" menu.</para></listitem> <listitem><para>In Eclipse, select "Install New Software" from the "Help" menu.</para></listitem>
<listitem><para>Click "Add..." in the "Work with:" area.</para></listitem> <listitem><para>Click "Add..." in the "Work with:" area.</para></listitem>
<listitem><para>Enter <listitem><para>Enter
<filename>http://downloads.yoctoproject.org/releases/eclipse-plugin/1.1</filename> <filename>&ECLIPSE_DL_PLUGIN_URL;</filename>
in the URL field and provide a meaningful name in the "Name" field.</para></listitem> in the URL field and provide a meaningful name in the "Name" field.</para></listitem>
<listitem><para>Click "OK" to have the entry added to the "Work with:" <listitem><para>Click "OK" to have the entry added to the "Work with:"
drop-down list.</para></listitem> drop-down list.</para></listitem>
@ -254,8 +255,8 @@
<listitem><para>In Eclipse, select "Import" from the "File" menu.</para></listitem> <listitem><para>In Eclipse, select "Import" from the "File" menu.</para></listitem>
<listitem><para>Expand the "General" box and select "existing projects into workspace" <listitem><para>Expand the "General" box and select "existing projects into workspace"
and then click "Next".</para></listitem> and then click "Next".</para></listitem>
<listitem><para>Select the root directory and browse to "~/yocto-eclipse/plugins". <listitem><para>Select the root directory and browse to
</para></listitem> <filename>~/yocto-eclipse/plugins</filename>.</para></listitem>
<listitem><para>There will be three things there. <listitem><para>There will be three things there.
Select each one and install one at a time. Select each one and install one at a time.
Do all three.</para></listitem> Do all three.</para></listitem>
@ -354,7 +355,7 @@
The pull-down menu should have the supported architectures. The pull-down menu should have the supported architectures.
If the architecture you need is not listed in the menu, you If the architecture you need is not listed in the menu, you
will need to build the image. will need to build the image.
See the "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#building-image'>Building an Image</ulink>" section See the "<ulink url='&YOCTO_DOCS_QS_URL;#building-image'>Building an Image</ulink>" section
of The Yocto Project Quick Start for more information.</para></listitem> of The Yocto Project Quick Start for more information.</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
@ -581,7 +582,7 @@
host can use, you must have <filename>oprofile</filename> version 0.9.4 or host can use, you must have <filename>oprofile</filename> version 0.9.4 or
greater installed on the host.</para> greater installed on the host.</para>
<para>You can locate both the viewer and server from <para>You can locate both the viewer and server from
<ulink url='http://git.yoctoproject.org/cgit/cgit.cgi/oprofileui/'></ulink>. <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/oprofileui/'></ulink>.
<note>The <filename>oprofile-server</filename> is installed by default on <note>The <filename>oprofile-server</filename> is installed by default on
the <filename>core-image-sato-sdk</filename> image.</note></para></listitem> the <filename>core-image-sato-sdk</filename> image.</note></para></listitem>
<listitem><para><emphasis><filename>Lttng-ust</filename>:</emphasis> Selecting this tool runs <listitem><para><emphasis><filename>Lttng-ust</filename>:</emphasis> Selecting this tool runs

3
documentation/adt-manual/adt-intro.xml
View File

@ -1,5 +1,6 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!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-intro'> <chapter id='adt-intro'>

9
documentation/adt-manual/adt-manual.xml
View File

@ -1,5 +1,6 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!DOCTYPE book 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; ] >
<book id='adt-manual' lang='en' <book id='adt-manual' lang='en'
xmlns:xi="http://www.w3.org/2003/XInclude" xmlns:xi="http://www.w3.org/2003/XInclude"
@ -46,7 +47,7 @@
</revhistory> </revhistory>
<copyright> <copyright>
<year>2010-2012</year> <year>&COPYRIGHT_YEAR;</year>
<holder>Linux Foundation</holder> <holder>Linux Foundation</holder>
</copyright> </copyright>
@ -58,9 +59,9 @@
<note> <note>
Due to production processes, there could be differences between the Yocto Project Due to production processes, there could be differences between the Yocto Project
documentation bundled in the release tarball and the documentation bundled in the release tarball and the
<ulink url='http://www.yoctoproject.org/docs/latest/adt-manual/adt-manual.html'> <ulink url='&YOCTO_DOCS_ADT_URL;'>
Application Developer's Toolkit (ADT) User's Guide</ulink> on Application Developer's Toolkit (ADT) User's Guide</ulink> on
the <ulink url='http://www.yoctoproject.org'>Yocto Project</ulink> website. the <ulink url='&YOCTO_HOME_URL;'>Yocto Project</ulink> website.
For the latest version of this manual, see the manual on the website. For the latest version of this manual, see the manual on the website.
</note> </note>

5
documentation/adt-manual/adt-package.xml
View File

@ -1,5 +1,6 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!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-package'> <chapter id='adt-package'>
<title>Optionally Customizing the Development Packages Installation</title> <title>Optionally Customizing the Development Packages Installation</title>
@ -54,7 +55,7 @@
<note> <note>
For build performance information related to the PMS, see For build performance information related to the PMS, see
<ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html#ref-classes-package'>Packaging - <filename>package*.bbclass</filename></ulink> in The Yocto Project Reference Manual. <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-package'>Packaging - <filename>package*.bbclass</filename></ulink> in The Yocto Project Reference Manual.
</note> </note>
<para> <para>

48
documentation/adt-manual/adt-prepare.xml
View File

@ -1,5 +1,6 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" <!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'> <chapter id='adt-prepare'>
@ -56,9 +57,9 @@
<para> <para>
The ADT Installer is contained in the ADT Installer tarball. The ADT Installer is contained in the ADT Installer tarball.
You can download the tarball into any directory from the 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 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 Or, you can use BitBake to generate the tarball inside the existing Yocto Project
build tree. build tree.
</para> </para>
@ -81,9 +82,9 @@
$ cd ~ $ cd ~
$ mkdir yocto-project $ mkdir yocto-project
$ cd yocto-project $ cd yocto-project
$ wget http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/poky-edison-6.0.tar.bz2 $ wget &YOCTO_RELEASE_DL_URL;/&YOCTO_POKY_TARBALL;
$ tar xjf poky-edison-6.0.tar.bz2 $ tar xjf &YOCTO_POKY_TARBALL;
$ source poky-edison-6.0/oe-init-build-env $ source &OE_INIT_PATH;
$ bitbake adt-installer $ bitbake adt-installer
</literallayout> </literallayout>
</para> </para>
@ -173,11 +174,9 @@
<note> <note>
The ADT Installer requires the <filename>libtool</filename> package to complete. The ADT Installer requires the <filename>libtool</filename> package to complete.
If you install the recommended packages as described in the If you install the recommended packages as described in
"<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#packages'>Packages</ulink>" "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Packages</ulink>"
section of section of The Yocto Project Quick Start, then you will have libtool installed.
<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.
</note> </note>
<para> <para>
@ -191,7 +190,7 @@
<para> <para>
Once the installation completes, the ADT, which includes the cross-toolchain, is installed. Once the installation completes, the ADT, which includes the cross-toolchain, is installed.
You will notice environment setup files for the cross-toolchain in 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> and image tarballs in the <filename>adt-installer</filename>
directory according to your installer configurations, and the target sysroot located directory according to your installer configurations, and the target sysroot located
according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_&lt;arch&gt;</filename> variable according to the <filename>YOCTOADT_TARGET_SYSROOT_LOC_&lt;arch&gt;</filename> variable
@ -214,17 +213,17 @@
Follow these steps: Follow these steps:
<orderedlist> <orderedlist>
<listitem><para>Go to <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 and find the folder that matches your host development system
(i.e. <filename>i686</filename> for 32-bit machines or (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 <listitem><para>Go into that folder and download the toolchain tarball whose name
includes the appropriate target architecture. includes the appropriate target architecture.
For example, if your host development system is an Intel-based 64-bit system and 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 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: <filename>x86_64</filename> folder and download the following tarball:
<literallayout class='monospaced'> <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> </literallayout>
<note><para>As an alternative to steps one and two, you can build the toolchain tarball <note><para>As an alternative to steps one and two, you can build the toolchain tarball
if you have a Yocto Project build tree. if you have a Yocto Project build tree.
@ -241,7 +240,7 @@
</para></note></para></listitem> </para></note></para></listitem>
<listitem><para>Make sure you are in the root directory with root privileges and then expand <listitem><para>Make sure you are in the root directory with root privileges and then expand
the tarball. 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. Once the tarball is expanded, the cross-toolchain is installed.
You will notice environment setup files for the cross-toolchain in the directory. You will notice environment setup files for the cross-toolchain in the directory.
</para></listitem> </para></listitem>
@ -304,7 +303,7 @@
Before you can develop using the cross-toolchain, you need to set up the 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. 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, 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. directory.
If you installed the toolchain in the build tree, you can find the environment setup 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. 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 For example, the toolchain environment setup script for a 64-bit IA-based architecture would
be the following: be the following:
<literallayout class='monospaced'> <literallayout class='monospaced'>
/opt/poky/1.1/environment-setup-x86_64-poky-linux &YOCTO_ADTPATH_DIR;/environment-setup-x86_64-poky-linux
</literallayout> </literallayout>
</para> </para>
</section> </section>
@ -340,10 +339,8 @@
To get the kernel and filesystem images, you either have to build them or download To get the kernel and filesystem images, you either have to build them or download
pre-built versions. pre-built versions.
You can find examples for both these situations in the 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 "<ulink url='&YOCTO_DOCS_QS_URL;#test-run'>A Quick Test Run</ulink>" section of
Quick Test Run</ulink>" section of The Yocto Project Quick Start.
<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html'>
The Yocto Project Quick Start</ulink>.
</para> </para>
<para> <para>
@ -352,12 +349,11 @@
<filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>) <filename>mips</filename>, <filename>powerpc</filename>, and <filename>arm</filename>)
that you can use unaltered in the QEMU emulator. that you can use unaltered in the QEMU emulator.
These kernel images reside in the Yocto Project release 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. and are ideal for experimentation within Yocto Project.
For information on the image types you can build using the Yocto Project, see the 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='&YOCTO_DOCS_REF_URL;#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.
The Yocto Project Reference Manual</ulink>.
</para> </para>
<para> <para>