dev-manual: WIP - Some edits to Chapter 4 from the read-through.

(From yocto-docs rev: 8c38d549b490aa847e7a9ebefe93ddeb79dbc5f9)

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

1 files changed, 20 insertions, 13 deletions

diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml
index 2b68fa7a1f..59c392f9db 100644
--- a/documentation/dev-manual/dev-manual-model.xml
+++ b/documentation/dev-manual/dev-manual-model.xml
@@ -186,13 +186,15 @@
                     </para></listitem>
                 <listitem><para><emphasis>Make recipe changes to your new BSP layer</emphasis>:  Recipe
                     changes include altering recipes (<filename>.bb</filename> files), removing
-                    recipes you don't use, and adding new recipes or append files
+                    recipes you do not use, and adding new recipes or append files
                     (<filename>.bbappend</filename>) that you need to support your hardware.
                     </para></listitem>
                 <listitem><para><emphasis>Prepare for the build</emphasis>:  Once you have made all the
                     changes to your BSP layer, there remains a few things
                     you need to do for the OpenEmbedded build system in order for it to create your image.
                     You need to get the build environment ready by sourcing an environment setup script
+                    (i.e. <filename>oe-init-build-env</filename> or
+                    <filename>oe-init-build-env-memres</filename>)
                     and you need to be sure two key configuration files are configured appropriately:
                     the <filename>conf/local.conf</filename> and the
                     <filename>conf/bblayers.conf</filename> file.
@@ -206,9 +208,9 @@
                     You might want to reference this information.</para></listitem>
                 <listitem><para><emphasis>Build the image</emphasis>:  The OpenEmbedded build system
                     uses the BitBake tool to build images based on the type of image you want to create.
-                    You can find more information about BitBake in the user manual, which is found in the
-                    <filename>bitbake/doc/manual</filename> directory of the
-                    <link linkend='source-directory'>Source Directory</link>.</para>
+                    You can find more information about BitBake in the
+                    <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual</ulink>.
+                    </para>
                     <para>The build process supports several types of images to satisfy different needs.
                     See the
                     "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" chapter
@@ -220,6 +222,7 @@
         <para>
             You can view a video presentation on "Building Custom Embedded Images with Yocto"
             at <ulink url='http://free-electrons.com/blog/elc-2011-videos'>Free Electrons</ulink>.
+            After going to the page, just search for "Embedded".
             You can also find supplemental information in the
             <ulink url='&YOCTO_DOCS_BSP_URL;'>
             Yocto Project Board Support Package (BSP) Developer's Guide</ulink>.
@@ -280,6 +283,9 @@
                     <listitem><para><emphasis><filename>linux-yocto-3.10</filename></emphasis> - The
                     stable Yocto Project kernel to use with the Yocto Project Release 1.5. This kernel
                     is based on the Linux 3.10 released kernel.</para></listitem>
+                    <listitem><para><emphasis><filename>linux-yocto-3.14</filename></emphasis> - The
+                    stable Yocto Project kernel to use with the Yocto Project Release 1.6. This kernel
+                    is based on the Linux 3.14 released kernel.</para></listitem>
                     <listitem><para><emphasis><filename>linux-yocto-dev</filename></emphasis> - A development
                     kernel based on the latest upstream release candidate available.</para></listitem>
                 </itemizedlist>
@@ -377,7 +383,7 @@
             </para>
 
             <para>
-                Again, for additional information the Yocto Project kernel's
+                Again, for additional information on the Yocto Project kernel's
                 architecture and its branching strategy, see the
                 <ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;'>Yocto Project Linux Kernel Development Manual</ulink>.
                 You can also reference the
@@ -417,11 +423,12 @@
                         <link linkend='build-directory'>Build Directory</link>
                         created by the
                         OpenEmbedded build system when you run BitBake.
-                        If you have never built the kernel you are interested in, you need to run
-                        an initial build to establish local kernel source files.</para>
+                        If you have never built the kernel in which you are
+                        interested, you need to run an initial build to
+                        establish local kernel source files.</para>
                         <para>If you are building an image for the first time, you need to get the build
                         environment ready by sourcing an environment setup script
-                        (e.g. <filename>oe-init-build-env</filename> or
+                        (i.e. <filename>oe-init-build-env</filename> or
                         <filename>oe-init-build-env-memres</filename>).
                         You also need to be sure two key configuration files
                         (<filename>local.conf</filename> and <filename>bblayers.conf</filename>)
@@ -430,9 +437,9 @@
                         "<ulink url='&YOCTO_DOCS_QS_URL;#building-image'>Building an Image</ulink>"
                         section of the Yocto Project Quick Start.
                         You might want to reference this information.
-                        You can find more information on BitBake in the user manual, which is found in the
-                        <filename>bitbake/doc/manual</filename> directory of the
-                        Source Directory.</para>
+                        You can find more information on BitBake in the
+                        <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual</ulink>.
+                        </para>
                         <para>The build process supports several types of images to satisfy different needs.
                         See the "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" chapter in
                         the Yocto Project Reference Manual for information on supported images.
@@ -441,7 +448,7 @@
                         applicable</emphasis>:  Modifying the kernel does not always mean directly
                         changing source files.
                         However, if you have to do this, you make the changes to the files in the
-                        Build directory.</para></listitem>
+                        Build Directory.</para></listitem>
                     <listitem><para><emphasis>Make kernel configuration changes
                         if applicable</emphasis>:
                         If your situation calls for changing the kernel's configuration, you can
@@ -478,7 +485,7 @@
         to run on your target hardware, which is running a kernel image created using the
         OpenEmbedded build system.
         The Yocto Project provides an
-        <ulink url='&YOCTO_DOCS_ADT_URL;#adt-intro-section'>Application Development Toolkit (ADT)</ulink>
+        <ulink url='&YOCTO_DOCS_ADT_URL;#adt-intro'>Application Development Toolkit (ADT)</ulink>
         and stand-alone
         <ulink url='&YOCTO_DOCS_ADT_URL;#the-cross-development-toolchain'>cross-development toolchains</ulink>
         that facilitate quick development and integration of your application into its runtime environment.