From be3c73bc02da6f1bb2698a5d8ddee1c4fdd0ba58 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 22 Oct 2012 13:16:49 -0700 Subject: documentation: dev-manual - Final changes before 1.3 lockdown. Made minor changes as needed due to some new sections, links, and capitalization standards. (From yocto-docs rev: bc966e5a78dadd14ecf1896a36e40a9b256bae77) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-start.xml | 31 ++++++++++++++------------- 1 file changed, 16 insertions(+), 15 deletions(-) (limited to 'documentation/dev-manual/dev-manual-start.xml') diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index e55a07d87a..11d4adca9f 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -56,8 +56,9 @@ OpenSUSE, Ubuntu, or CentOS as these releases are frequently tested against the Yocto Project and officially supported. For a list of the distributions under validation and their status, see the - Distribution - Support wiki page. + "Supported Linux Distributions" section + in the Yocto Project Reference Manual and the wiki page at + Distribution Support. You should also have about 100 gigabytes of free disk space for building images. @@ -69,12 +70,12 @@ for the supported distributions. Yocto Project Release: You need a release of the Yocto Project. - You set up a with local source directory + You set up a with local Source Directory one of two ways depending on whether you are going to contribute back into the Yocto Project or not. Regardless of the method you use, this manual refers to the resulting local - hierarchical set of files as the "source directory." + hierarchical set of files as the "Source Directory." Tarball Extraction: If you are not going to contribute @@ -83,7 +84,7 @@ Once you have the tarball, just extract it into a directory of your choice. For example, the following command extracts the Yocto Project &DISTRO; release tarball - into the current working directory and sets up the local source directory + into the current working directory and sets up the local Source Directory with a top-level folder named &YOCTO_POKY;: $ tar xfj &YOCTO_POKY_TARBALL; @@ -125,11 +126,11 @@ You can find Git repositories of supported Yocto Project Kernels organized under "Yocto Linux Kernel" in the Yocto Project Source Repositories at . - This setup involves creating a bare clone of the Yocto Project kernel and then + This setup can involve creating a bare clone of the Yocto Project kernel and then copying that cloned repository. You can create the bare clone and the copy of the bare clone anywhere you like. For simplicity, it is recommended that you create these structures outside of the - source directory (usually poky). + Source Directory (usually poky). As an example, the following transcript shows how to create the bare clone of the linux-yocto-3.4 kernel and then create a copy of that clone. @@ -168,9 +169,9 @@ You can find the poky-extras Git Repository in the "Yocto Metadata Layers" area of the Yocto Project Source Repositories at . - It is good practice to create this Git repository inside the source directory. + It is good practice to create this Git repository inside the Source Directory. Following is an example that creates the poky-extras Git - repository inside the source directory, which is named poky + repository inside the Source Directory, which is named poky in this case: $ cd ~/poky @@ -192,7 +193,7 @@ layer. You can get set up for BSP development one of two ways: tarball extraction or with a local Git repository. - It is a good idea to use the same method that you used to set up the source directory. + It is a good idea to use the same method that you used to set up the Source Directory. Regardless of the method you use, the Yocto Project uses the following BSP layer naming scheme: @@ -218,13 +219,13 @@ Again, this method just produces a snapshot of the BSP layer in the form of a hierarchical directory structure. Git Repository Method: If you are working - with a local Git repository for your source directory, you should also use this method + with a local Git repository for your Source Directory, you should also use this method to set up the meta-intel Git repository. You can locate the meta-intel Git repository in the "Yocto Metadata Layers" area of the Yocto Project Source Repositories at . Typically, you set up the meta-intel Git repository inside - the source directory. + the Source Directory. For example, the following transcript shows the steps to clone the meta-intel Git repository inside the local poky Git repository. @@ -266,13 +267,13 @@ The build process is as follows: - Make sure you have set up the source directory described in the + Make sure you have set up the Source Directory described in the previous section. Initialize the build environment by sourcing a build environment script. Optionally ensure the conf/local.conf configuration file, which is found in the - build directory, + Build Directory, is set up how you want it. This file defines many aspects of the build environment including the target machine architecture through the @@ -298,7 +299,7 @@ Another option you have to get started is to use pre-built binaries. The Yocto Project provides many types of binaries with each release. - See the Images + See the "Images" chapter in the Yocto Project Reference Manual for descriptions of the types of binaries that ship with a Yocto Project release. -- cgit v1.2.3-54-g00ecf