diff --git a/documentation/sdk-manual/sdk-appendix-obtain.xml b/documentation/sdk-manual/sdk-appendix-obtain.xml
index 3fae8052ac..ae30995304 100644
--- a/documentation/sdk-manual/sdk-appendix-obtain.xml
+++ b/documentation/sdk-manual/sdk-appendix-obtain.xml
@@ -91,65 +91,94 @@
As an alternative to locating and downloading a SDK installer,
- you can build the SDK installer assuming you have first sourced
- the environment setup script.
- See the
- "Building Images"
- section in the Yocto Project Quick Start for steps that show you
- how to set up the Yocto Project environment.
- In particular, you need to be sure the
- MACHINE
- variable matches the architecture for which you are building and that
- the
- SDKMACHINE
- variable is correctly set if you are building a toolchain designed to
- run on an architecture that differs from your current development host
- machine (i.e. the build machine).
-
-
-
- To build the SDK installer for a standard SDK and populate
- the SDK image, use the following command:
-
+ you can build the SDK installer.
+ Follow these steps:
+
+
+ Set Up the Build Environment:
+ Be sure you are set up to use BitBake in a shell.
+ See the
+ "Building Images"
+ section in the Yocto Project Quick Start for steps that
+ show you how to set up the Yocto Project environment.
+
+
+ Make Sure You Are Building an Installer for the Correct Machine:
+ Check to be sure that your
+ MACHINE
+ variable in the local.conf file in your
+ Build Directory
+ matches the architecture for which you are building.
+
+
+ Make Sure Your SDK Machine is Correctly Set:
+ If you are building a toolchain designed to run on an
+ architecture that differs from your current development host
+ machine (i.e. the build machine), be sure that the
+ SDKMACHINE
+ variable in the local.conf file in your
+ Build Directory is correctly set.
+
+
+ Build the SDK Installer:
+ To build the SDK installer for a standard SDK and populate
+ the SDK image, use the following command form.
+ Be sure to replace image with
+ an image (e.g. "core-image-sato"):
+
$ bitbake image -c populate_sdk
-
- You can do the same for the extensible SDK using this command:
-
+
+ You can do the same for the extensible SDK using this command
+ form:
+
$ bitbake image -c populate_sdk_ext
-
- These commands result in a SDK installer that contains the sysroot
- that matches your target root filesystem.
-
+
+ These commands result in a SDK installer that contains the
+ sysroot that matches your target root filesystem.
-
- When the bitbake command completes, the SDK
- installer will be in
- tmp/deploy/sdk in the Build Directory.
- Notes
-
-
- By default, this toolchain does not build static binaries.
- If you want to use the toolchain to build these types of
- libraries, you need to be sure your SDK has the
- appropriate static development libraries.
- Use the
- TOOLCHAIN_TARGET_TASK
- variable inside your local.conf file
- to install the appropriate library packages in the SDK.
- Following is an example using libc
- static development libraries:
-
+ When the bitbake command completes,
+ the SDK installer will be in
+ tmp/deploy/sdk in the Build Directory.
+ Notes
+
+
+ By default, this toolchain does not build static
+ binaries.
+ If you want to use the toolchain to build these
+ types of libraries, you need to be sure your SDK
+ has the appropriate static development libraries.
+ Use the
+ TOOLCHAIN_TARGET_TASK
+ variable inside your local.conf
+ file to install the appropriate library packages
+ in the SDK.
+ Following is an example using
+ libc static development
+ libraries:
+
TOOLCHAIN_TARGET_TASK_append = " libc-staticdev"
-
-
-
- For additional information on building the installer,
- see the
- Cookbook guide to Making an Eclipse Debug Capable Image
- wiki page.
-
-
-
+
+
+
+ For additional information on building the
+ installer, see the
+ Cookbook guide to Making an Eclipse Debug Capable Image
+ wiki page.
+
+
+
+
+
+ Run the Installer:
+ You can now run the SDK installer from
+ tmp/deploy/sdk in the Build Directory.
+ Following is an example:
+
+ $ cd ~/poky/build/tmp/deploy/sdk
+ ./poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh
+
+
+