From 1c597ac036d3a548f41a0f788ec225722d702d0a Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <scott.m.rifenbark@intel.com>
Date: Mon, 15 Apr 2013 13:37:21 -0700
Subject: [PATCH] dev-manual, bsp-guide: Scrubbed the yocto-layer usage
 section.

Added a note in the bsp-guide to point back to the main
new section, which is in the dev-manual.

Made some small edits to the main section in the dev-manual.

(From yocto-docs rev: 4105c8edbdc531b2a941d7f7282325fae763f059)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/bsp-guide/bsp.xml                   |  9 +++++++++
 .../dev-manual/dev-manual-common-tasks.xml        | 15 +++++++--------
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index 76b533e9b4..e61ea019e4 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -1161,6 +1161,15 @@
                     by the Yocto Project, as well as QEMU versions of the same.
                     The default mode of the script's operation is to prompt you for information needed
                     to generate the BSP layer.
+                    <note>
+                        For information on creating a general layer that is not BSP-specific,
+                        see the 
+                        "<ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-general-layer-using-the-yocto-layer-script'>Creating a General Layer Using the yocto-layer Script</ulink>"
+                        in the Yocto Project Development Manual.
+                    </note>
+                </para>                    
+
+                <para>
                     For the current set of BSPs, the script prompts you for various important
                     parameters such as:
                     <itemizedlist>
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 7e8369c977..bca869aa2d 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -623,7 +623,7 @@
             </para>
 
             <para>
-                You use the <filename>yocto-layer create</filename> sub-command
+                Use the <filename>yocto-layer create</filename> sub-command
                 to create a new general layer.
                 In its simplest form, you can create a layer as follows:
                 <literallayout class='monospaced'>
@@ -636,18 +636,17 @@
             <para>
                 As the <filename>yocto-layer create</filename> command runs,
                 default values for the prompts appear in brackets.
-                Pressing enter without supplying anything on the command line
+                Pressing enter without supplying anything for the prompts
                 or pressing enter and providing an invalid response causes the
                 script to accept the default value.
                 Once the script completes, the new layer
                 is created in the current working directory.
-                The script names the layer according to the string you provide
-                and the prepended <filename>meta-</filename> string.
+                The script names the layer by prepending 
+                <filename>meta-</filename> to the name you provide.
             </para>
 
             <para>
-                If you choose to not generate a sample recipe or append file,
-                the script creates the following within the layer:
+                Minimally, the script creates the following within the layer:
                 <itemizedlist>
                     <listitem><para><emphasis>The <filename>conf</filename>
                         directory:</emphasis>
@@ -674,7 +673,7 @@
                 in a directory named <filename>recipes-example</filename>.
                 The script creates a <filename>.bb</filename> file and a
                 directory, which contains a sample
-                <filename>helloworld.c</filename>source file and along with
+                <filename>helloworld.c</filename> source file and along with
                 a sample patch file.
                 If you do not provide a recipe name, the script uses
                 "example".
@@ -721,7 +720,7 @@
         "
                 </literallayout>
                 Adding the layer to this file enables the build system to
-                the layer during the build.
+                locate the layer during the build.
                 </para>
         </section>
     </section>