dev-manual: Edits to "Yocto Project Terms" section.

(From yocto-docs rev: d5742f17daccbaab752e9c82f12dbc9b166bb901)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 29 insertions, 28 deletions

diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 48d42d50b7..3193403e85 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -444,14 +444,14 @@
     <para>
         In summary, here is where you can get the project files needed for development:
         <itemizedlist>
-            <listitem><para id='source-repositories'><emphasis><ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi'>Source Repositories:</ulink></emphasis>
+            <listitem><para id='source-repositories'>:S<emphasis><ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi'>Source Repositories:</ulink></emphasis>
                 This area contains IDE Plugins, Matchbox, Poky, Poky Support, Tools, Yocto Linux Kernel, and Yocto
                 Metadata Layers.
                 You can create local copies of Git repositories for each of these areas.</para>
                 <para>
                 <imagedata fileref="figures/source-repos.png" align="center" width="6in" depth="4in" />
                 </para></listitem>
-            <listitem><para><anchor id='index-downloads' /><emphasis><ulink url='&YOCTO_DL_URL;/releases/'>Index of /releases:</ulink></emphasis>
+            <listitem><para><anchor id='index-downloads' />:<emphasis><ulink url='&YOCTO_DL_URL;/releases/'>Index of /releases:</ulink></emphasis>
                 This area contains index releases such as
                 the <trademark class='trade'>Eclipse</trademark>
                 Yocto Plug-in, miscellaneous support, poky, pseudo, installers for cross-development toolchains,
@@ -487,9 +487,10 @@
             <listitem><para><emphasis>Append Files:</emphasis> Files that append build information to
                 a recipe file.
                 Append files are known as BitBake append files and <filename>.bbappend</filename> files.
-                The OpenEmbedded build system expects every append file to have a corresponding and
-                underlying recipe (<filename>.bb</filename>) file.
-                Furthermore, the append file and the underlying recipe must have the same root filename.
+                The OpenEmbedded build system expects every append file to have a corresponding
+                recipe (<filename>.bb</filename>) file.
+                Furthermore, the append file and corresponding recipe file 
+                must use the same root filename.
                 The filenames can differ only in the file type suffix used (e.g.
                 <filename>formfactor_0.0.bb</filename> and <filename>formfactor_0.0.bbappend</filename>).
                 </para>
@@ -508,7 +509,7 @@
                 This term refers to the area used by the OpenEmbedded build system for builds.
                 The area is created when you <filename>source</filename> the setup
                 environment script that is found in the Source Directory
-                (i.e. <filename>&OE_INIT_FILE;</filename>).
+                (i.e. <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>).
                 The <ulink url='&YOCTO_DOCS_REF_URL;#var-TOPDIR'><filename>TOPDIR</filename></ulink>
                 variable points to the Build Directory.</para>
 
@@ -529,22 +530,21 @@
                             <literallayout class='monospaced'>
      $ source &OE_INIT_PATH; $HOME/mybuilds/YP-&POKYVERSION;
                             </literallayout></para></listitem>
-                        <listitem><para>Provide an existing directory to use as the Build Directory.
-                            This example uses the existing <filename>mybuilds</filename> directory
-                            as the Build Directory.
+                        <listitem><para>Provide an existing directory to use as the Build Directory
+                            and use the default <filename>build</filename> name.
                             <literallayout class='monospaced'>
      $ source &OE_INIT_PATH; $HOME/mybuilds/
                             </literallayout></para></listitem>
                     </itemizedlist>
                 </para></listitem>
-            <listitem><para><emphasis>Build System:</emphasis> In the context of the Yocto Project
+            <listitem><para><emphasis>Build System:</emphasis> In the context of the Yocto Project,
                 this term refers to the OpenEmbedded build system used by the project.
                 This build system is based on the project known as "Poky."
                 For some historical information about Poky, see the
-                <link linkend='poky'>Poky</link> term further along in this section.
+                <link linkend='poky'>Poky</link> term.
                 </para></listitem>
             <listitem><para><emphasis>Classes:</emphasis> Files that provide for logic encapsulation
-                and inheritance allowing commonly used patterns to be defined once and easily used
+                and inheritance so that commonly used patterns can be defined once and then easily used
                 in multiple recipes.
                 Class files end with the <filename>.bbclass</filename> filename extension.
                 </para></listitem>
@@ -554,7 +554,7 @@
                 <link linkend='build-directory'>Build Directory</link>
                 contains user-defined variables that affect each build.
                 The <filename>meta-yocto/conf/distro/poky.conf</filename> configuration file
-                defines Yocto ‘distro’ configuration
+                defines Yocto "distro" configuration
                 variables used only when building with this policy.
                 Machine configuration files, which
                 are located throughout the
@@ -586,18 +586,18 @@
                         The initial compiler needed to bootstrap the toolchain
                         that runs on the host and is used to build software
                         for the target.
-                        This tool is a 'native' package.</para></listitem>
+                        This tool is a "native" package.</para></listitem>
                     <listitem><para><filename>gcc-cross-intermediate</filename>:
                         The second stage of the bootstrap process that runs
                         on the host and builds software for the target.
-                        This tool is a 'native' package.</para></listitem>
+                        This tool is a "native" package.</para></listitem>
                     <listitem><para><filename>gcc-cross</filename>:
                         The the final stage of the bootstrap process that
                         results in the cross compiler that runs on the host
                         and builds software for the target.
                         If you are replacing the cross compiler toolchain
                         with a custom version, this is what you must replace.
-                        This tool is a 'native' package.</para></listitem>
+                        This tool is a "native" package.</para></listitem>
                     <listitem><para><filename>gcc-runtime</filename>:
                         Runtime libraries from the toolchain bootstrapping
                         process.
@@ -607,20 +607,20 @@
                         Stage 1 and 2 of the a cross compiler that runs on the
                         host and builds for the SDK.
                         Often the SDK is not the same target as the host.
-                        This tool is a 'native' binary.</para></listitem>
+                        This tool is a "native" binary.</para></listitem>
                     <listitem><para><filename>gcc-crosssdk</filename>:
                         The final stage of the SDK compiler.
-                        This tool is a 'native' binary.
+                        This tool is a "native" binary.
                         The tool runs on the host and builds for the SDK.
                         </para></listitem>
                     <listitem><para><filename>gcc-cross-canadian</filename>:
                         The compiler that runs on the SDK machine and is
                         included with the SDK that builds software for the
                         target.
-                        This tool is a 'nativesdk' package.</para></listitem>
+                        This tool is a "nativesdk" package.</para></listitem>
                 </itemizedlist></para></listitem>
             <listitem><para><emphasis>Image:</emphasis> An image is the result produced when
-                BitBake processes a given collection of recipes and related metadata.
+                BitBake processes a given collection of recipes and related Metadata.
                 Images are the binary output that run on specific hardware or QEMU
                 and for specific use cases.
                 For a list of the supported image types that the Yocto Project provides, see the
@@ -636,17 +636,17 @@
                 In general, Metadata includes recipes, classes, and
                 configuration files.
                 In the context of the kernel ("kernel Metadata"),
-                it refers to metadata in the <filename>meta</filename>
+                it refers to Metadata in the <filename>meta</filename>
                 branches of the kernel source Git repositories.
                 </para></listitem>
-            <listitem><para id='oe-core'><emphasis>OE-Core:</emphasis> A core set of metadata originating
+            <listitem><para id='oe-core'><emphasis>OE-Core:</emphasis> A core set of Metadata originating
                 with OpenEmbedded (OE) that is shared between OE and the Yocto Project.
-                This metadata is found in the <filename>meta</filename> directory of the source
-                directory.</para></listitem>
+                This Metadata is found in the <filename>meta</filename> directory of the 
+                <link linkend='source-directory'>Source Directory</link>.</para></listitem>
             <listitem><para><emphasis>Package:</emphasis> In the context of the Yocto Project,
                 this term refers to the packaged output from a baked recipe.
                 A package is generally the compiled binaries produced from the recipe's sources.
-                You ‘bake’ something by running it through BitBake.</para>
+                You "bake" something by running it through BitBake.</para>
                 <para>It is worth noting that the term "package" can, in general, have subtle
                 meanings.  For example, the packages referred to in the
                 "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Packages</ulink>" section are
@@ -666,7 +666,8 @@
                 build system becoming a build system for embedded images.
                 After Intel Corporation acquired OpenedHand, the project poky became the basis for
                 the Yocto Project's build system.
-                Within the Yocto Project source repositories, poky exists as a separate Git repository
+                Within the Yocto Project source repositories, <filename>poky</filename>
+                exists as a separate Git repository
                 that can be cloned to yield a local copy on the host system.
                 Thus, "poky" can refer to the local copy of the Source Directory used to develop within
                 the Yocto Project.</para></listitem>
@@ -690,7 +691,7 @@
                     Be sure that the Source Directory you use does not contain these types
                     of names.
                 </note></para>
-                <para>The Source Directory contains BitBake, Documentation, metadata and
+                <para>The Source Directory contains BitBake, Documentation, Metadata and
                 other files that all support the Yocto Project.
                 Consequently, you must have the Source Directory in place on your development
                 system in order to do any development using the Yocto Project.</para>
@@ -729,7 +730,7 @@
                 "<link linkend='repositories-tags-and-branches'>Repositories, Tags, and Branches</link>"
                 section.</para></listitem>
             <listitem><para><emphasis>Tasks:</emphasis> Arbitrary groups of software Recipes.
-                You simply use Tasks to hold recipes that, when built, usually accomplish a single task.
+                You use tasks to hold recipes that, when built, usually accomplish a single task.
                 For example, a task could contain the recipes for a company’s proprietary or value-add software.
                 Or, the task could contain the recipes that enable graphics.
                 A task is really just another recipe.