diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index 73da290303..250398e63a 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -804,29 +804,23 @@
gives you a minimal description of how to use the Yocto Project to build images
for a BeagleBoard xM starting from scratch.
- The steps were performed on a 64-bit Ubuntu 10.04 system.
+ The steps were performed on a 64-bit Ubuntu 12.04 system.
Getting the Yocto Project
- Set up your Source Directory
- one of two ways:
-
- Tarball:
- Use if you want the latest stable release:
-
- $ wget &YOCTO_RELEASE_DL_URL;/&YOCTO_POKY_TARBALL;
- $ tar xvjf &YOCTO_POKY_TARBALL;
-
- Git Repository:
- Use if you want to work with cutting edge development content:
-
+ Set up your
+ Source Directory
+ by using Git to clone the poky poky
+ repository and then check out the release branch:
+
+ $ cd ~
$ git clone git://git.yoctoproject.org/poky
-
-
- The remainder of the section assumes the Git repository method.
+ $ cd poky
+ $ git checkout -b &DISTRO_NAME; origin/&DISTRO_NAME;
+
@@ -835,7 +829,8 @@
You need some packages for everything to work.
- Rather than duplicate them here, look at the "The Packages"
+ Rather than duplicate them here, look at the
+ "The Packages"
section earlier in this quick start.
@@ -844,17 +839,18 @@
Initializing the Build Environment
- From the parent directory your
+ From the root directory of your
Source Directory,
initialize your environment and provide a meaningful
Build Directory
name:
- $ source poky/&OE_INIT_FILE; mybuilds
+ $ source &OE_INIT_FILE; mybuilds
- At this point, the mybuilds directory has been created for you
- and it is now your current working directory.
- If you don't provide your own directory name it defaults to build,
+ At this point, the mybuilds directory has
+ been created for you and it is now your current working directory.
+ If you don't provide your own directory name,
+ it defaults to build,
which is inside the Source Directory.
@@ -863,18 +859,21 @@
Configuring the local.conf File
- Initializing the build environment creates a conf/local.conf configuration file
+ Initializing the build environment creates a
+ conf/local.conf configuration file
in the Build Directory.
- You need to manually edit this file to specify the machine you are building and to optimize
- your build time.
+ You need to manually edit this file to specify the machine you
+ are building and to optimize your build time.
Here are the minimal changes to make:
BB_NUMBER_THREADS = "8"
PARALLEL_MAKE = "-j 8"
MACHINE ?= "beagleboard"
- Briefly, set BB_NUMBER_THREADS
- and PARALLEL_MAKE to
+ Briefly, set
+ BB_NUMBER_THREADS
+ and
+ PARALLEL_MAKE to
twice your host processor's number of cores.
@@ -924,9 +923,10 @@
Building the Image
- At this point, you need to select an image to build for the BeagleBoard xM.
- If this is your first build using the Yocto Project, you should try the smallest and simplest
- image:
+ At this point, you need to select an image to build for the
+ BeagleBoard xM.
+ If this is your first build using the Yocto Project, you should try
+ the smallest and simplest image:
$ bitbake core-image-minimal
@@ -936,15 +936,18 @@
Here are some variations on the build process that could be helpful:
- Fetch all the necessary sources without starting the build:
+ Fetch all the necessary sources without starting
+ the build:
$ bitbake -c fetchall core-image-minimal
- This variation guarantees that you have all the sources for that BitBake target
- should you disconnect from the net and want to do the build later offline.
-
- Specify to continue the build even if BitBake encounters an error.
- By default, BitBake aborts the build when it encounters an error.
+ This variation guarantees that you have all the sources for
+ that BitBake target should you disconnect from the net and
+ want to do the build later offline.
+ Specify to continue the build even if BitBake
+ encounters an error.
+ By default, BitBake aborts the build when it encounters an
+ error.
This command keeps a faulty build going:
$ bitbake -k core-image-minimal
@@ -953,7 +956,8 @@
- Once you have your image, you can take steps to load and boot it on the target hardware.
+ Once you have your image, you can take steps to load and boot it on
+ the target hardware.