diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml
index 3d902e4e5f..b4e27baf6f 100644
--- a/documentation/adt-manual/adt-prepare.xml
+++ b/documentation/adt-manual/adt-prepare.xml
@@ -516,31 +516,62 @@
Extracting the Root Filesystem
- You must extract the root filesystem if you want to boot the image using NFS
- or you want to use the root filesystem as the target sysroot.
- For example, the Eclipse IDE environment with the Eclipse Yocto Plug-in installed allows you
- to use QEMU to boot under NFS.
- Another example is if you want to develop your target application using the
- root filesystem as the target sysroot.
+ If you install your toolchain by hand or build it using BitBake and
+ you need a root filesystem, you need to extract it separately.
+ If you use the ADT Installer to install the ADT, the root
+ filesystem is automatically extracted and installed.
+
+
+
+ Here are some cases where you need to extract the root filesystem:
+
+ You want to boot the image using NFS.
+
+ You want to use the root filesystem as the
+ target sysroot.
+ For example, the Eclipse IDE environment with the Eclipse
+ Yocto Plug-in installed allows you to use QEMU to boot
+ under NFS.
+ You want to develop your target application
+ using the root filesystem as the target sysroot.
+
+
To extract the root filesystem, first source
- the cross-development environment setup script and then
- use the runqemu-extract-sdk command on the
+ the cross-development environment setup script.
+ If you built the toolchain in the Build Directory, you will find
+ the toolchain environment script in the
+ tmp directory.
+ If you installed the toolchain by hand, the environment setup
+ script is located in opt/poky/&DISTRO;.
+
+
+
+ After sourcing the environment script, use the
+ runqemu-extract-sdk command and provide the
filesystem image.
- For example, the following commands set up the environment and then extract
- the root filesystem from a previously built filesystem image tarball named
- core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2.
- The example extracts the root filesystem into the $HOME/qemux86-sato
- directory:
+
+
+
+ Following is an example.
+ The second command sets up the environment.
+ In this case, the setup script is located in the
+ /opt/poky/&DISTRO; directory.
+ The third command extracts the root filesystem from a previously
+ built filesystem that is located in the
+ ~/Downloads directory.
+ Furthermore, this command extracts the root filesystem into the
+ $HOME/qemux86-sato directory:
- $ source $HOME/toolchain_dir/environment-setup-i586-poky-linux
+ $ cd ~
+ $ source /opt/poky/&DISTRO;/environment-setup-i586-poky-linux
$ runqemu-extract-sdk \
~Downloads/core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2 \
$HOME/qemux86-sato
- In this case, you could now point to the target sysroot at
+ You could now point to the target sysroot at
$HOME/qemux86-sato.