diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml
index 48a82f53ef..8a1bc67599 100644
--- a/documentation/adt-manual/adt-prepare.xml
+++ b/documentation/adt-manual/adt-prepare.xml
@@ -336,24 +336,72 @@
Quick Test Run" section of
The Yocto Project Quick Start.
-
+
+
+
The Yocto Project provides basic kernel and filesystem images for several
architectures (x86, x86-64,
mips, powerpc, and arm)
that you can use unaltered in the QEMU emulator.
These kernel images reside in the Yocto Project release
area -
- and are ideal for experimentation within Yocto Project.
- If you plan on remotely deploying and debugging your application from within the
- Eclipse IDE, you must have an image that contains the Yocto Target Communication
- Framework (TCF) agent (tcf-agent), which is the
- core-image-sato-sdk image.
- For information on the image types you can build using the Yocto Project, see
-
- Reference: Images in
+ and are ideal for experimentation within Yocto Project.
+ For information on the image types you can build using the Yocto Project, see the
+ "Reference: Images" appendix in
- The Yocto Project Reference Manual.
-
+ The Yocto Project Reference Manual.
+
+
+
+ If you plan on remotely deploying and debugging your application from within the
+ Eclipse IDE, you must have an image that contains the Yocto Target Communication
+ Framework (TCF) agent (tcf-agent).
+ By default, the Yocto Project provides only one pre-built image that contains the
+ tcf-agent.
+ And, that image is core-image-sato-sdk.
+
+
+
+ If you want to use a different image type that contains the tcf-agent,
+ you can do so one of two ways:
+
+ Modify the conf/local.conf configuration in
+ the Yocto Project build directory and then rebuild the image.
+ With this method you need to modify the EXTRA_IMAGE_FEATURES
+ variable to have the value of "tools-debug" before rebuilding the image.
+ Once the image is rebuilt, the tcf-agent will be included
+ in the image and is launched automatically after the boot.
+ Manually build the tcf-agent.
+ To build the agent, follow these steps:
+
+ Be sure the ADT is installed as described in the
+ "Installing the ADT" section.
+
+ Set up the cross-development environment as described in the
+ "Setting
+ Up the Cross-Development Environment" section.
+ Get the tcf-agent source code, which is
+ stored using the Subversion SCM, using the following command:
+
+ $ svn checkout svn://dev.eclipse.org/svnroot/dsdp/org.eclipse.tm.tcf/trunk/agent \
+ <-r #rev_number>
+
+ Modify the Makefile.inc file
+ for the cross-compilation environment by setting the
+ OPSYS and MACHINE
+ variables according to your target.
+ Use the cross-development tools to build the
+ tcf-agent.
+ Before you "Make" the file, be sure your cross-tools are set up first.
+ See the "Makefile-Based Projects"
+ section for information on how to make sure the cross-tools are set up
+ correctly.
+ If the build is successful, the tcf-agent output will
+ be obj/$(OPSYS)/$(MACHINE)/Debug/agent.
+ Deploy the agent into the image's root filesystem.
+
+
+