summaryrefslogtreecommitdiff
path: root/documentation/adt-manual
diff options
context:
space:
mode:
authorRichard Purdie <richard.purdie@linuxfoundation.org>2011-04-20 14:20:19 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2011-04-20 15:49:17 +0100
commit50021cba20a09b1ed685db5466f940b17d4880ac (patch)
tree3bdafb797e6466ad58727b002f1235933010ab11 /documentation/adt-manual
parent690e87a2ffe8caa16379be26eb356c5bded17c1f (diff)
downloadopenembedded-core-50021cba20a09b1ed685db5466f940b17d4880ac.tar.gz
openembedded-core-50021cba20a09b1ed685db5466f940b17d4880ac.tar.bz2
openembedded-core-50021cba20a09b1ed685db5466f940b17d4880ac.zip
Drop documentation directory, this is replaced by the new yocto-docs repository
Diffstat (limited to 'documentation/adt-manual')
-rw-r--r--documentation/adt-manual/Makefile42
-rw-r--r--documentation/adt-manual/adt-command.xml66
-rw-r--r--documentation/adt-manual/adt-eclipse.xml435
-rw-r--r--documentation/adt-manual/adt-intro.xml117
-rw-r--r--documentation/adt-manual/adt-manual-customization.xsl8
-rw-r--r--documentation/adt-manual/adt-manual.xml70
-rw-r--r--documentation/adt-manual/adt-package.xml82
-rw-r--r--documentation/adt-manual/adt-prepare.xml244
-rw-r--r--documentation/adt-manual/figures/adt-title.pngbin14349 -> 0 bytes
-rwxr-xr-xdocumentation/adt-manual/figures/yocto-project-transp.pngbin8626 -> 0 bytes
-rw-r--r--documentation/adt-manual/style.css968
11 files changed, 0 insertions, 2032 deletions
diff --git a/documentation/adt-manual/Makefile b/documentation/adt-manual/Makefile
deleted file mode 100644
index 74e35bcdeb..0000000000
--- a/documentation/adt-manual/Makefile
+++ /dev/null
@@ -1,42 +0,0 @@
-XSLTOPTS = --stringparam html.stylesheet style.css \
- --stringparam chapter.autolabel 1 \
- --stringparam appendix.autolabel A \
- --stringparam section.autolabel 1 \
- --stringparam section.label.includes.component.label 1 \
- --xinclude
-
-##
-# These URI should be rewritten by your distribution's xml catalog to
-# match your localy installed XSL stylesheets.
-XSL_BASE_URI = http://docbook.sourceforge.net/release/xsl/current
-XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl
-
-all: html pdf tarball
-
-pdf:
- ../tools/poky-docbook-to-pdf adt-manual.xml ../template
-
-##
-# These URI should be rewritten by your distribution's xml catalog to
-# match your localy installed XSL stylesheets.
-
-html:
-# See http://www.sagehill.net/docbookxsl/HtmlOutput.html
-
-# xsltproc $(XSLTOPTS) -o adt-manual.html $(XSL_XHTML_URI) adt-manual.xml
- xsltproc $(XSLTOPTS) -o adt-manual.html adt-manual-customization.xsl adt-manual.xml
-
-tarball: html
- tar -cvzf adt-manual.tgz adt-manual.html adt-manual.pdf style.css figures/adt-title.png figures/yocto-project-transp.png
-
-validate:
- xmllint --postvalid --xinclude --noout adt-manual.xml
-
-OUTPUTS = adt-manual.tgz adt-manual.html adt-manual.pdf
-SOURCES = *.png *.xml *.css
-
-publish:
- scp -r $(OUTPUTS) $(SOURCES) o-hand.com:/srv/www/pokylinux.org/doc/
-
-clean:
- rm -f $(OUTPUTS)
diff --git a/documentation/adt-manual/adt-command.xml b/documentation/adt-manual/adt-command.xml
deleted file mode 100644
index e57c15a983..0000000000
--- a/documentation/adt-manual/adt-command.xml
+++ /dev/null
@@ -1,66 +0,0 @@
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<chapter id='using-the-command-line'>
-<title>Using the Command Line</title>
- <para>
- Recall that earlier we talked about how to use an existing toolchain
- tarball that had been installed into <filename>/opt/poky</filename>,
- which is outside of the Poky build environment
- (see <xref linkend='using-an-existing-toolchain-tarball'>
- “Using an Existing Toolchain Tarball”)</xref>.
- And, that sourcing your architecture-specific environment setup script
- initializes a suitable development environment.
- This setup occurs by adding the compiler, QEMU scripts, QEMU binary,
- a special version of <filename>pkgconfig</filename> and other useful
- utilities to the <filename>PATH</filename> variable.
- Variables to assist pkgconfig and autotools are also defined so that,
- for example, <filename>configure.sh</filename> can find pre-generated
- test results for tests that need target hardware on which to run.
- These conditions allow you to easily use the toolchain outside of the
- Poky build environment on both autotools-based projects and
- makefile-based projects.
- </para>
-
-<section id='autotools-based-projects'>
-<title>Autotools-Based Projects</title>
- <para>
- For an autotools-based project you can use the cross-toolchain by just
- passing the appropriate host option to <filename>configure.sh</filename>.
- The host option you use is derived from the name of the environment setup
- script in <filename>/opt/poky</filename> resulting from unpacking the
- cross-toolchain tarball.
- For example, the host option for an ARM-based target that uses the GNU EABI
- is <filename>armv5te-poky-linux-gnueabi</filename>.
- Note that the name of the script is
- <filename>environment-setup-armv5te-poky-linux-gnueabi</filename>.
- Thus, the following command works:
- <literallayout class='monospaced'>
- $ configure &dash;&dash;host-armv5te-poky-linux-gnueabi &dash;&dash;with-libtool-sysroot=&lt;sysroot-dir&gt;
- </literallayout>
- </para>
- <para>
- This single command updates your project and rebuilds it using the appropriate
- cross-toolchain tools.
- </para>
-</section>
-
-<section id='makefile-based-projects'>
-<title>Makefile-Based Projects</title>
- <para>
- For a makefile-based project you use the cross-toolchain by making sure
- the tools are used.
- You can do this as follows:
- <literallayout class='monospaced'>
- CC=arm-poky-linux-gnueabi-gcc
- LD=arm-poky-linux-gnueabi-ld
- CFLAGS=”${CFLAGS} &dash;&dash;sysroot=&lt;sysroot-dir&gt;”
- CXXFLAGS=”${CXXFLAGS} &dash;&dash;sysroot=&lt;sysroot-dir&gt;”
- </literallayout>
- </para>
-</section>
-
-</chapter>
-<!--
-vim: expandtab tw=80 ts=4
--->
diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml
deleted file mode 100644
index ee305fe585..0000000000
--- a/documentation/adt-manual/adt-eclipse.xml
+++ /dev/null
@@ -1,435 +0,0 @@
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<chapter id='adt-eclipse'>
-<title>Working Within Eclipse</title>
- <para>
- The Eclipse IDE is a popular development environment and it fully supports
- development using Yocto Project.
- When you install and configure the Eclipse Yocto Project Plug-in into
- the Eclipse IDE you maximize your Yocto Project design experience.
- Installing and configuring the Plug-in results in an environment that
- has extensions specifically designed to let you more easily develop software.
- These extensions allow for cross-compilation and deployment and execution of
- your output into a QEMU emulation session.
- You can also perform cross-debugging and profiling.
- The environment also has a suite of tools that allows you to perform
- remote profiling, tracing, collection of power data, collection of
- latency data, and collection of performance data.
- </para>
- <para>
- This section describes how to install and configure the Eclipse IDE
- Yocto Plug-in and how to use it to develop your Yocto Project.
- </para>
-
-<section id='setting-up-the-eclipse-ide'>
- <title>Setting Up the Eclipse IDE</title>
- <para>
- To develop within the Eclipse IDE you need to do the following:
- <orderedlist>
- <listitem><para>Be sure the optimal version of Eclipse IDE
- is installed.</para></listitem>
- <listitem><para>Install required Eclipse plug-ins prior to installing
- the Eclipse Yocto Plug-in.</para></listitem>
- <listitem><para>Configure the Eclipse Yocto Plug-in.</para></listitem>
- </orderedlist>
- </para>
-
- <section id='installing-eclipse-ide'>
- <title>Installing Eclipse IDE</title>
- <para>
- It is recommended that you have the Helios 3.6.1 version of the
- Eclipse IDE installed on your development system.
- If you don’t have this version you can find it at
- <ulink url='http://www.eclipse.org/downloads'></ulink>.
- From that site, choose the Eclipse Classic version.
- This version contains the Eclipse Platform, the Java Development
- Tools (JDT), and the Plug-in Development Environment.
- </para>
- <para>
- Once you have downloaded the tarball, extract it into a clean
- directory and complete the installation.
- </para>
- <para>
- One issue exists that you need to be aware of regarding the Java
- Virtual machine’s garbage collection (GC) process.
- The GC process does not clean up the permanent generation
- space (PermGen).
- This space stores meta-data descriptions of classes.
- The default value is set too small and it could trigger an
- out-of-memory error such as the following:
- <literallayout class='monospaced'>
- Java.lang.OutOfMemoryError: PermGen space
- </literallayout>
- </para>
- <para>
- This error causes the application to hang.
- </para>
- <para>
- To fix this issue you can use the &dash;&dash;vmargs option when you start
- Eclipse to increase the size of the permanent generation space:
- <literallayout class='monospaced'>
- eclipse &dash;&dash;vmargs &dash;&dash;XX:PermSize=256M
- </literallayout>
- </para>
- </section>
-
- <section id='installing-required-plug-ins-and-the-eclipse-yocto-plug-in'>
- <title>Installing Required Plug-ins and the Eclipse Yocto Plug-in</title>
- <para>
- Before installing the Yocto Plug-in you need to be sure that the
- CDT 7.0, RSE 3.2, and Autotools plug-ins are all installed in the
- following order.
- After installing these three plug-ins, you can install the
- Eclipse Yocto Plug-in.
- Use the following URLs for the plug-ins:
- <orderedlist>
- <listitem><para><emphasis>CDT 7.0</emphasis> –
- <ulink url='http://download.eclipse.org/tools/cdt/releases/helios/'></ulink>:
- For CDT main features select the checkbox so you get all items.
- For CDT optional features expand the selections and check
- “C/C++ Remote Launch”.</para></listitem>
- <listitem><para><emphasis>RSE 3.2</emphasis> –
- <ulink url='http://download.eclipse.org/tm/updates/3.2'></ulink>:
- Check the box next to “TM and RSE Main Features” so you select all
- those items.
- Note that all items in the main features depend on 3.2.1 version.
- Expand the items under “TM and RSE Uncategorized 3.2.1” and
- select the following: “Remote System Explorer End-User Runtime”,
- “Remote System Explorer Extended SDK”, “Remote System Explorer User Actions”,
- “RSE Core”, “RSE Terminals UI”, and “Target Management Terminal”.</para></listitem>
- <listitem><para><emphasis>Autotools</emphasis> –
- <ulink url='http://download.eclipse.org/technology/linuxtools/update/'></ulink>:
- Expand the items under “Linux Tools” and select “Autotools support for
- CDT (Incubation)”.</para></listitem>
- <listitem><para><emphasis>Yocto Plug-in</emphasis> –
- <ulink url='http://www.yoctoproject.org/downloads/eclipse-plugin/1.0'></ulink>:
- Check the box next to “Development tools &amp; SDKs for Yocto Linux”
- to select all the items.</para></listitem>
- </orderedlist>
- </para>
- <para>
- Follow these general steps to install a plug-in:
- <orderedlist>
- <listitem><para>From within the Eclipse IDE select the
- “Install New Software” item from the “Help” menu.</para></listitem>
- <listitem><para>Click “Add…” in the “Work with:” area.</para></listitem>
- <listitem><para>Enter the URL for the repository and leave the “Name”
- field blank.</para></listitem>
- <listitem><para>Check the boxes next to the software you need to
- install and then complete the installation.
- For information on the specific software packages you need to include,
- see the previous list.</para></listitem>
- </orderedlist>
- </para>
- </section>
-
- <section id='configuring-the-plug-in'>
- <title>Configuring the Plug-in</title>
- <para>
- Configuring the Eclipse Yocto Plug-in involves choosing the Cross
- Compiler Options, selecting the Target Architecture, and choosing
- the Target Options.
- These settings are the default settings for all projects.
- You do have opportunities to change them later if you choose to when
- you configure the project.
- See “Configuring the Cross Toolchain” section later in the manual.
- </para>
- <para>
- To start, you need to do the following from within the Eclipse IDE:
- <itemizedlist>
- <listitem><para>Choose Windows -&gt; Preferences to display
- the Preferences Dialog</para></listitem>
- <listitem><para>Click “Yocto SDK”</para></listitem>
- </itemizedlist>
- </para>
-
- <section id='configuring-the-cross-compiler-options'>
- <title>Configuring the Cross-Compiler Options</title>
- <para>
- Choose between ‘SDK Root Mode’ and ‘Poky Tree Mode’ for Cross
- Compiler Options.
- <itemizedlist>
- <listitem><para><emphasis>SDK Root Mode</emphasis> – Select this mode
- when you are not concerned with building an image or you do not have
- a Poky build tree on your system.
- For example, suppose you are an application developer and do not
- need to build an image.
- You just want to use an architecture-specific toolchain on an
- existing kernel and root filesystem.
- When you use SDK Root Mode you are using the toolchain installed
- in the <filename>/opt/poky</filename> directory.</para></listitem>
- <listitem><para><emphasis>Poky Tree Mode</emphasis> – Select this mode
- if you are concerned with building images for hardware or your
- development environment already has a build tree.
- In this case you likely already have a Poky build tree installed on
- your system or you (or someone else) will be building one.
- When you use the Poky Tree Mode you are using the toolchain bundled
- inside the Poky build tree.
- If you use this mode you must also supply the Poky Root Location
- in the Preferences Dialog.</para></listitem>
- </itemizedlist>
- </para>
- </section>
-
- <section id='configuring-the-sysroot'>
- <title>Configuring the Sysroot</title>
- <para>
- Specify the sysroot, which is used by both the QEMU user-space
- NFS boot process and by the cross-toolchain regardless of the
- mode you select (SDK Root Mode or Poky Tree Mode).
- For example, sysroot is the location to which you extract the
- downloaded image’s root filesystem to through the ADT Installer.
- </para>
- </section>
-
- <section id='selecting-the-target-architecture'>
- <title>Selecting the Target Architecture</title>
- <para>
- Use the pull-down Target Architecture menu and select the
- target architecture.
- </para>
- <para>
- The Target Architecture is the type of hardware you are
- going to use or emulate.
- This pull-down menu should have the supported architectures.
- If the architecture you need is not listed in the menu then you
- will need to re-visit
- <xref linkend='adt-prepare'>
- “Preparing to Use the Application Development Toolkit (ADT)”</xref>
- section earlier in this document.
- </para>
- </section>
-
- <section id='choosing-the-target-options'>
- <title>Choosing the Target Options</title>
- <para>
- You can choose to emulate hardware using the QEMU emulator, or you
- can choose to use actual hardware.
- <itemizedlist>
- <listitem><para><emphasis>External HW</emphasis> – Select this option
- if you will be using actual hardware.</para></listitem>
- <listitem><para><emphasis>QEMU</emphasis> – Select this option if
- you will be using the QEMU emulator.
- If you are using the emulator you also need to locate the Kernel
- and you can specify custom options.</para>
- <para>In Poky Tree Mode the kernel you built will be located in the
- Poky Build tree in <filename>tmp/deploy/images</filename> directory.
- In SDK Root Mode the pre-built kernel you downloaded is located
- in the directory you specified when you downloaded the image.</para>
- <para>Most custom options are for advanced QEMU users to further
- customize their QEMU instance.
- These options are specified between paired angled brackets.
- Some options must be specified outside the brackets.
- In particular, the options <filename>serial</filename>,
- <filename>nographic</filename>, and <filename>kvm</filename> must all
- be outside the brackets.
- Use the <filename>man qemu</filename> command to get help on all the options
- and their use.
- The following is an example:
- <literallayout class='monospaced'>
- serial ‘&lt;-m 256 -full-screen&gt;’
- </literallayout>
- </para>
- <para>
- Regardless of the mode, Sysroot is already defined in the “Sysroot”
- field.</para></listitem>
- </itemizedlist>
- </para>
- <para>
- Click the “OK” button to save your plug-in configurations.
- </para>
- </section>
- </section>
-</section>
-
-<section id='creating-the-project'>
-<title>Creating the Project</title>
- <para>
- You can create two types of projects: Autotools-based, or Makefile-based.
- This section describes how to create autotools-based projects from within
- the Eclipse IDE.
- For information on creating projects in a terminal window see
- <xref linkend='using-the-command-line'> “Using the Command Line”</xref>
- section.
- </para>
- <para>
- To create a project based on a Yocto template and then display the source code,
- follow these steps:
- <orderedlist>
- <listitem><para>Select File -> New -> Project.</para></listitem>
- <listitem><para>Double click “CC++”.</para></listitem>
- <listitem><para>Double click “C Project” to create the project.</para></listitem>
- <listitem><para>Double click “Yocto SDK Project”.</para></listitem>
- <listitem><para>Select “Hello World ANSI C Autotools Project”.
- This is an Autotools-based project based on a Yocto Project template.</para></listitem>
- <listitem><para>Put a name in the “Project name:” field.</para></listitem>
- <listitem><para>Click “Next”.</para></listitem>
- <listitem><para>Add information in the “Author” field.</para></listitem>
- <listitem><para>Use “GNU General Public License v2.0” for the License.</para></listitem>
- <listitem><para>Click “Finish”.</para></listitem>
- <listitem><para>Answer ‘Yes” to the open perspective prompt.</para></listitem>
- <listitem><para>In the Project Explorer expand your project.</para></listitem>
- <listitem><para>Expand ‘src’.</para></listitem>
- <listitem><para>Double click on your source file and the code appears
- in the window.
- This is the template.</para></listitem>
- </orderedlist>
- </para>
-</section>
-
-<section id='configuring-the-cross-toolchains'>
-<title>Configuring the Cross-Toolchains</title>
- <para>
- The previous section, <xref linkend='configuring-the-cross-compiler-options'>
- “Configuring the Cross-Compiler Options”</xref>, set up the default project
- configurations.
- You can change these settings for a given project by following these steps:
- <orderedlist>
- <listitem><para>Select Project -> Invoke Yocto Tools -> Reconfigure Yocto.
- This brings up the project Yocto Settings Dialog.
- Settings are inherited from the default project configuration.
- The information in this dialogue is identical to that chosen earlier
- for the Cross Compiler Option (SDK Root Mode or Poky Tree Mode),
- the Target Architecture, and the Target Options.
- The settings are inherited from the Yocto Plug-in configuration performed
- after installing the plug-in.</para></listitem>
- <listitem><para>Select Project -> Reconfigure Project.
- This runs the <filename>autogen.sh</filename> in the workspace for your project.
- The script runs <filename>libtoolize</filename>, <filename>aclocal</filename>,
- <filename>autoconf</filename>, <filename>autoheader</filename>,
- <filename>automake &dash;&dash;a</filename>, and
- <filename>./configure</filename>.</para></listitem>
- </orderedlist>
- </para>
-</section>
-
-<section id='building-the-project'>
-<title>Building the Project</title>
- <para>
- To build the project, select Project -&gt; Build Project.
- You should see the console updated and you can note the cross-compiler you are using.
- </para>
-</section>
-
-<section id='starting-qemu-in-user-space-nfs-mode'>
-<title>Starting QEMU in User Space NFS Mode</title>
- <para>
- To start the QEMU emulator from within Eclipse, follow these steps:
- <orderedlist>
- <listitem><para>Select Run -> External Tools -> External Tools Configurations...
- This selection brings up the External Tools Configurations Dialogue.</para></listitem>
- <listitem><para>Go to the left navigation area and expand ‘Program’.
- You should find the image listed.
- For example, qemu-x86_64-poky-linux.</para></listitem>
- <listitem><para>Click on the image.
- This brings up a new environment in the main area of the External
- Tools Configurations Dialogue.
- The Main tab is selected.</para></listitem>
- <listitem><para>Click “Run” next.
- This brings up a shell window.</para></listitem>
- <listitem><para>Enter your host root password in the shell window at the prompt.
- This sets up a Tap 0 connection needed for running in user-space NFS mode.</para></listitem>
- <listitem><para>Wait for QEMU to launch.</para></listitem>
- <listitem><para>Once QEMU launches you need to determine the IP Address
- for the user-space NFS.
- You can do that by going to a terminal in the QEMU and entering the
- <filename>ipconfig</filename> command.</para></listitem>
- </orderedlist>
- </para>
-</section>
-
-<section id='deploying-and-debugging-the-application'>
-<title>Deploying and Debugging the Application</title>
- <para>
- Once QEMU is running you can deploy your application and use the emulator
- to perform debugging.
- Follow these steps to deploy the application.
- <orderedlist>
- <listitem><para>Select Run -> Debug Configurations...</para></listitem>
- <listitem><para>In the left area expand “C/C++Remote Application”.</para></listitem>
- <listitem><para>Locate your project and select it to bring up a new
- tabbed view in the Debug Configurations dialogue.</para></listitem>
- <listitem><para>Enter the absolute path into which you want to deploy
- the application.
- Use the Remote Absolute File Path for C/C++Application:.
- For example, enter <filename>/usr/bin/&lt;programname&gt;</filename>.</para></listitem>
- <listitem><para>Click on the Debugger tab to see the cross-tool debugger
- you are using.</para></listitem>
- <listitem><para>Create a new connection to the QEMU instance
- by clicking on “new”.</para></listitem>
- <listitem><para>Select “TCF, which means Target Communication Framework.</para></listitem>
- <listitem><para>Click “Next”.</para></listitem>
- <listitem><para>Clear out the “host name” field and enter the IP Address
- determined earlier.</para></listitem>
- <listitem><para>Click Finish to close the new connections dialogue.</para></listitem>
- <listitem><para>Use the drop-down menu now in the “Connection” field and pick
- the IP Address you entered.</para></listitem>
- <listitem><para>Click “Debug” to bring up a login screen and login.</para></listitem>
- <listitem><para>Accept the debug perspective.</para></listitem>
- </orderedlist>
- </para>
-</section>
-
-<section id='running-user-space-tools'>
-<title>Running User-Space Tools</title>
- <para>
- As mentioned earlier in the manual several tools exist that enhance
- your development experience.
- These tools are aids in developing and debugging applications and images.
- You can run these user-space tools from within the Yocto Eclipse
- Plug-in through the Window -> YoctoTools menu.
- </para>
- <para>
- Once you pick a tool you need to configure it for the remote target.
- Every tool needs to have the connection configured.
- You must select an existing TCF-based RSE connection to the remote target.
- If one does not exist, click "New" to create one.
- </para>
- <para>
- Here are some specifics about the remote tools:
- <itemizedlist>
- <listitem><para><emphasis>OProfile:</emphasis> Selecting this tool causes
- the oprofile-server on the remote target to launch on the local host machine.
- The oprofile-viewer must be installed on the local host machine and the
- oprofile-server must be installed on the remote target, respectively, in order
- to use.
- You can locate both the viewer and server from
- <ulink url='http://git.yoctoproject.org/cgit/cgit.cgi/oprofileui/'></ulink>.
- You need to compile and install the oprofile-viewer from the source code
- on your local host machine.
- The oprofile-server is installed by default in the image.</para></listitem>
- <listitem><para><emphasis>Lttng-ust:</emphasis> Selecting this tool runs
- "usttrace" on the remote target, transfers the output data back to the
- local host machine and uses "lttv-gui" to graphically display the output.
- The "lttv-gui" must be installed on the local host machine to use this tool.
- For information on how to use "lttng" to trace an application, see
- <ulink url='http://lttng.org/files/ust/manual/ust.html'></ulink>.</para>
- <para>For "Application" you must supply the absolute path name of the
- application to be traced by user mode lttng.
- For example, typing <filename>/path/to/foo</filename> triggers
- <filename>usttrace /path/to/foo</filename> on the remote target to trace the
- program <filename>/path/to/foo</filename>.</para>
- <para>"Argument" is passed to <filename>usttrace</filename>
- running on the remote target.</para></listitem>
- <listitem><para><emphasis>PowerTOP:</emphasis> Selecting this tool runs
- "PowerTOP" on the remote target machine and displays the results in a
- new view called "powertop".</para>
- <para>"Time to gather data(sec):" is the time passed in seconds before data
- is gathered from the remote target for analysis.</para>
- <para>"show pids in wakeups list:" corresponds to the -p argument
- passed to "powertop".</para></listitem>
- <listitem><para><emphasis>LatencyTOP and Perf:</emphasis> "LatencyTOP"
- identifies system latency, while "perf" monitors the system's
- performance counter registers.
- Selecting either of these tools causes an RSE terminal view to appear
- from which you can run the tools.
- Both tools refresh the entire screen to display results while they run.</para></listitem>
- </itemizedlist>
- </para>
-</section>
-
-</chapter>
-<!--
-vim: expandtab tw=80 ts=4
--->
diff --git a/documentation/adt-manual/adt-intro.xml b/documentation/adt-manual/adt-intro.xml
deleted file mode 100644
index 8740e5cf3e..0000000000
--- a/documentation/adt-manual/adt-intro.xml
+++ /dev/null
@@ -1,117 +0,0 @@
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<chapter id='adt-intro'>
-
-<title>Application Development Toolkit (ADT) User's Guide</title>
-
-<para>
- Welcome to the Application Development Toolkit User’s Guide. This manual provides
- information that lets you get going with the ADT to develop projects using the Yocto
- Project.
-</para>
-
-<section id='book-intro'>
- <title>Introducing the Application Development Toolkit (ADT)</title>
- <para>
- Fundamentally, the ADT consists of an architecture-specific cross-toolchain and
- a matching sysroot that are both built by the Poky build system.
- The toolchain and sysroot are based on a metadata configuration and extensions,
- which allows you to cross develop for the target on the host machine.
- </para>
- <para>
- Additionally, to provide an effective development platform, the Yocto Project
- makes available and suggests other tools as part of the ADT.
- These other tools include the Eclipse IDE Yocto Plug-in, an emulator (QEMU),
- and various user-space tools that greatly enhance your development experience.
- </para>
- <para>
- The resulting combination of the architecture-specific cross-toolchain and sysroot
- along with these additional tools yields a custom-built, cross-development platform
- for a user-targeted product.
- </para>
-
- <section id='the-cross-toolchain'>
- <title>The Cross-Toolchain</title>
- <para>
- The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger
- that are all generated through a Poky build that is based on your metadata
- configuration or extension for your targeted device.
- The cross-toolchain works with a matching target sysroot.
- </para>
- </section>
-
- <section id='sysroot'>
- <title>Sysroot</title>
- <para>
- The matching target sysroot contains needed headers and libraries for generating
- binaries that run on the target architecture.
- The sysroot is based on the target root filesystem image that is built by
- Poky and uses the same metadata configuration used to build the cross-toolchain.
- </para>
- </section>
-
- <section id='the-qemu-emulator'>
- <title>The QEMU Emulator</title>
- <para>
- The QEMU emulator allows you to simulate your hardware while running your
- application or image.
- QEMU is installed several ways: as part of the Poky tree, ADT installation
- through a toolchain tarball, or through the ADT Installer.
- </para>
- </section>
-
- <section id='user-space-tools'>
- <title>User-Space Tools</title>
- <para>
- User-space tools are included as part of the distribution.
- You will find these tools helpful during development.
- The tools include LatencyTOP, PowerTOP, OProfile, Perf, SystemTap, and Lttng-ust.
- These tools are common development tools for the Linux platform.
- <itemizedlist>
- <listitem><para><emphasis>LatencyTOP</emphasis> – LatencyTOP focuses on latency
- that causes skips in audio,
- stutters in your desktop experience, or situations that overload your server
- even when you have plenty of CPU power left.
- You can find out more about LatencyTOP at
- <ulink url='http://www.latencytop.org/'></ulink>.
- </para></listitem>
- <listitem><para><emphasis>PowerTOP</emphasis> – Helps you determine what
- software is using the most power.
- You can find out more about PowerTOP at
- <ulink url='http://www.linuxpowertop.org/'></ulink>.
- </para></listitem>
- <listitem><para><emphasis>OProfile</emphasis> – A system-wide profiler for Linux
- systems that is capable
- of profiling all running code at low overhead.
- You can find out more about OProfile at
- <ulink url='http://oprofile.sourceforge.net/about/'></ulink>.
- </para></listitem>
- <listitem><para><emphasis>Perf</emphasis> – Performance counters for Linux used
- to keep track of certain
- types of hardware and software events.
- For more information on these types of counters see
- <ulink url='https://perf.wiki.kernel.org/index.php'></ulink> and click
- on “Perf tools.”
-