diff --git a/documentation/dev-manual/dev-manual-kernel-appendix.xml b/documentation/dev-manual/dev-manual-kernel-appendix.xml
index efbe9d4c60..06db1f91a8 100644
--- a/documentation/dev-manual/dev-manual-kernel-appendix.xml
+++ b/documentation/dev-manual/dev-manual-kernel-appendix.xml
@@ -248,8 +248,8 @@
of cores your machine supports and set PARALLEL_MAKE to one and
a half times the number of cores your machine supports.
- The following two commands build the default qemux86 image and
- source build environment setup script.
+ The following two commands source the build environment setup script
+ and build the default qemux86 image.
If necessary, the script creates the build directory:
$ cd ~/poky
@@ -532,46 +532,94 @@
in "Modifying the Kernel Source
Code" you should already have the Yocto Project files set up on your
host machine.
+ If this is the case, go to then next section titled
+ "Examining the Default
+ CONFIG_SMP Behavior" and continue with the
+ example.
If you don't have the Yocto Project files established on your system,
- See "Setting
- Up the Local Yocto Project Files Git Repository" for
- information.
- To reconfigure the kernel, this is the only Git repository you need to have set up.
+ you can get them through tarball extraction or by
+ cloning the poky Git repository.
+ This example uses poky as the root directory of the
+ local Yocto Project files Git repository.
+ See the bulleted item
+ "Yocto Project Release"
+ for information on how to get these files.
-
+ Next, you need to build the default qemux86 image that you
+ can boot using QEMU.
+
+ Because a full build can take hours, you should check two variables in the
+ build directory that is created after you source the
+ oe-init-build-env script.
+ You can find these variables
+ BB_NUMBER_THREADS and PARALLEL_MAKE
+ in the build/conf directory in the
+ local.conf configuration file.
+ By default, these variables are commented out.
+ If your host development system supports multi-core and multi-thread capabilities,
+ you can uncomment these statements and set the variables to significantly shorten
+ the full build time.
+ As a guideline, set BB_NUMBER_THREADS to twice the number
+ of cores your machine supports and set PARALLEL_MAKE to one and
+ a half times the number of cores your machine supports.
+
+ The following two commands source the build environment setup script
+ and build the default qemux86 image.
+ If necessary, the script creates the build directory:
+
+ $ cd ~/poky
+ $ source oe-init-build-env
+
+ ### Shell environment set up for builds. ###
+
+ You can now run 'bitbake <target>'
+
+ Common targets are:
+ core-image-minimal
+ core-image-sato
+ meta-toolchain
+ meta-toolchain-sdk
+ adt-installer
+ meta-ide-support
+
+ You can also run generated qemu images with a command like 'runqemu qemux86'
+
+
+
+
+ The following bitbake command starts the build:
+
+ $ bitbake -k core-image-minimal
+
+ Be sure to check the settings in the local.conf
+ before starting the build.
+