diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2012-10-22 13:16:49 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2012-10-23 00:03:13 +0100 |
commit | 2b51188de67f16423da2b0c0b3859b8900de6828 (patch) | |
tree | 097066d4bd084095625d8006c8913f760cc16b5d /documentation/dev-manual/dev-manual-start.xml | |
parent | f3c1226cc8572a00fece289e93f0a0fd0c090fa6 (diff) | |
download | openembedded-core-contrib-2b51188de67f16423da2b0c0b3859b8900de6828.tar.gz |
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 <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual/dev-manual-start.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 31 |
1 files changed, 16 insertions, 15 deletions
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 - <ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution - Support</ulink> wiki page.</para> + "<ulink url='&YOCTO_DOCS_REF_URL;#detailed-supported-distros'>Supported Linux Distributions</ulink>" section + in the Yocto Project Reference Manual and the wiki page at + <ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution Support</ulink>.</para> <para> You should also have about 100 gigabytes of free disk space for building images. </para></listitem> @@ -69,12 +70,12 @@ for the supported distributions.</para></listitem> <listitem id='local-yp-release'><para><emphasis>Yocto Project Release:</emphasis> You need a release of the Yocto Project. - You set up a with local <link linkend='source-directory'>source directory</link> + You set up a with local <link linkend='source-directory'>Source Directory</link> one of two ways depending on whether you are going to contribute back into the Yocto Project or not. <note> 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." </note> <itemizedlist> <listitem><para><emphasis>Tarball Extraction:</emphasis> 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.</para> <para>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 <filename>&YOCTO_POKY;</filename>: <literallayout class='monospaced'> $ 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 <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink>.</para> - <para>This setup involves creating a bare clone of the Yocto Project kernel and then + <para>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 <filename>poky</filename>).</para> + Source Directory (usually <filename>poky</filename>).</para> <para>As an example, the following transcript shows how to create the bare clone of the <filename>linux-yocto-3.4</filename> kernel and then create a copy of that clone. @@ -168,9 +169,9 @@ <para>You can find the <filename>poky-extras</filename> Git Repository in the "Yocto Metadata Layers" area of the Yocto Project Source Repositories at <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink>. - It is good practice to create this Git repository inside the source directory.</para> + It is good practice to create this Git repository inside the Source Directory.</para> <para>Following is an example that creates the <filename>poky-extras</filename> Git - repository inside the source directory, which is named <filename>poky</filename> + repository inside the Source Directory, which is named <filename>poky</filename> in this case: <literallayout class='monospaced'> $ 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: <literallayout class='monospaced'> @@ -218,13 +219,13 @@ Again, this method just produces a snapshot of the BSP layer in the form of a hierarchical directory structure.</para></listitem> <listitem><para><emphasis>Git Repository Method:</emphasis> 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 <filename>meta-intel</filename> Git repository. You can locate the <filename>meta-intel</filename> Git repository in the "Yocto Metadata Layers" area of the Yocto Project Source Repositories at <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink>.</para> <para>Typically, you set up the <filename>meta-intel</filename> Git repository inside - the source directory. + the Source Directory. For example, the following transcript shows the steps to clone the <filename>meta-intel</filename> Git repository inside the local <filename>poky</filename> Git repository. @@ -266,13 +267,13 @@ <para> The build process is as follows: <orderedlist> - <listitem><para>Make sure you have set up the source directory described in the + <listitem><para>Make sure you have set up the Source Directory described in the previous section.</para></listitem> <listitem><para>Initialize the build environment by sourcing a build environment script.</para></listitem> <listitem><para>Optionally ensure the <filename>conf/local.conf</filename> configuration file, which is found in the - <link linkend='build-directory'>build directory</link>, + <link linkend='build-directory'>Build Directory</link>, 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 @@ <para> 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 <ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink> + See the "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" chapter in the Yocto Project Reference Manual for descriptions of the types of binaries that ship with a Yocto Project release. |