documentation/poky-ref-manual/development.xml: Garman's partial review comments

(From yocto-docs rev: 329401ac13e60381ca74a617ae398586cbd5dfed)

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

1 files changed, 12 insertions, 11 deletions

diff --git a/documentation/poky-ref-manual/development.xml b/documentation/poky-ref-manual/development.xml
index 797d79f5ad..53e6904545 100644
--- a/documentation/poky-ref-manual/development.xml
+++ b/documentation/poky-ref-manual/development.xml
@@ -19,21 +19,22 @@
         <para>
             The Yocto Project provides toolchains that allow you to develop your application 
             outside of the Yocto Project build system for specific hardware.
-            These toolchains (called meta-toolchains) contain cross-development tools like compilers, 
-            linkers, and debuggers that build your application for your target.
-            The Yocto Project also provides images that have toolchains set up for supported 
-            architectures.
+            These toolchains (called meta-toolchains) contain cross-development tools such as compilers, 
+            linkers, and debuggers that build your application for your target device.
+            The Yocto Project also provides images that have toolchains for supported 
+            architectures included within the image.
+            This allows you to compile, debug, or profile applications directly on the target device.
             See  
             <xref linkend='ref-images'>Reference: Images</xref> for a listing of the image
             types that Yocto Project supports.
         </para> 
         <para>
             Using the BitBake tool you can build a meta-toolchain or meta-toolchain-sdk target,
-            which is in the form of a tarball. 
+            which generates a tarball. 
             Unpacking  this tarball into the <filename class="directory">/opt/poky</filename> directory 
             on your host produces a setup script 
             (e.g. <filename>/opt/poky/environment-setup-i586-poky-linux</filename>) that 
-            you can source to initialize your build environment. 
+            you can <filename>source</filename> to initialize your build environment. 
             Sourcing this script adds the compiler, QEMU scripts, QEMU binary, a special version of 
             <filename>pkgconfig</filename> and other 
             useful utilities to the <filename>PATH</filename> variable used by the Yocto Project
@@ -55,7 +56,7 @@
             that builds your application
             specify to use the cross-compiler <filename>arm-poky-linux-gnueabi-gcc</filename>
             and linker <filename>arm-poky-linux-gnueabi-ld</filename>, which are part of the 
-            meta-toolchain you have previously established:
+            meta-toolchain you would have previously established:
             <literallayout class='monospaced'>
      CC=arm-poky-linux-gnueabi-gcc;
      LD=arm-poky-linux-gnueabi-ld;
@@ -69,13 +70,13 @@
             The current release of the Yocto Project supports the Eclipse IDE plug-in
             to make developing software easier for the application developer. 
             The plug-in provides capability extensions to the graphical IDE to allow
-            for cross compilation, deployment and execution of the output in a QEMU 
+            for cross compilation, deployment and execution of the application within a QEMU 
             emulation session. 
             Support of the Eclipse plug-in also allows for cross debugging and
             profiling.  
             Additionally, the Eclipse plug-in provides a suite of tools 
             that allows the developer to perform remote profiling, tracing, collection of 
-            power data, collection of latency data and collection of performance data.
+            power consumption data, collection of latency data and collection of performance data.
         </para>
         <note>
             The current release of the Yocto Project no longer supports the Anjuta plug-in.
@@ -106,7 +107,7 @@
         </para>
         <para>
             The QEMU images shipped with the Yocto Project contain complete toolchains
-            native to specific target architectures.
+            native to their target architectures.
             This support allows you to develop applications within QEMU similar to the way 
             you would using a normal host development system.
         </para>
@@ -135,7 +136,7 @@
         </para>
 
         <para>
-            Several mechanisms exist that let you connect into the system running on the 
+            Several mechanisms exist that let you connect to the system running on the 
             QEMU emulator:
             <itemizedlist>
                 <listitem><para>QEMU provides a framebuffer interface that makes standard