[gnome-continuous-yocto/gnomeostree-3.28-rocko: 7858/8267] kernel-dev: Updates to creating a layer section.

[Emmanuele Bassi <ebassi src gnome org>]

commit 0767740f3289b41e02fd559aa24c6e35d90d3450
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Wed Sep 20 12:27:22 2017 -0700

    kernel-dev: Updates to creating a layer section.
    
    (From yocto-docs rev: a57ba3f227831225a544df1ab774422364b91d6f)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/kernel-dev/kernel-dev-common.xml |   29 +++++++++++++----------
 1 files changed, 16 insertions(+), 13 deletions(-)
---
diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml
index 24feb94..6179883 100644
--- a/documentation/kernel-dev/kernel-dev-common.xml
+++ b/documentation/kernel-dev/kernel-dev-common.xml
@@ -488,17 +488,20 @@
         <para>
             To better understand the layer you create for kernel development,
             the following section describes how to create a layer
-            without the aid of tools:
+            without the aid of tools.
+            These steps assume creation of a layer named
+            <filename>mylayer</filename> in your home directory:
             <orderedlist>
                 <listitem><para>
-                    <emphasis>Create additional structure</emphasis>:
-                    Create the additional layer structure:
+                    <emphasis>Create Structure</emphasis>:
+                    Create the layer's structure:
                     <literallayout class='monospaced'>
-     $ cd ~/poky/meta-mylayer
-     $ mkdir conf
-     $ mkdir recipes-kernel
-     $ mkdir recipes-kernel/linux
-     $ mkdir recipes-kernel/linux/linux-yocto
+     $ cd $HOME
+     $ mkdir meta-mylayer
+     $ mkdir meta-mylayer/conf
+     $ mkdir meta-mylayer/recipes-kernel
+     $ mkdir meta-mylayer/recipes-kernel/linux
+     $ mkdir meta-mylayer/recipes-kernel/linux/linux-yocto
                     </literallayout>
                     The <filename>conf</filename> directory holds your
                     configuration files, while the
@@ -506,7 +509,7 @@
                     append file and eventual patch files.
                     </para></listitem>
                 <listitem><para>
-                    <emphasis>Create the layer configuration file</emphasis>:
+                    <emphasis>Create the Layer Configuration File</emphasis>:
                     Move to the <filename>meta-mylayer/conf</filename>
                     directory and create the <filename>layer.conf</filename>
                     file as follows:
@@ -526,7 +529,7 @@
                     three statements.
                     </para></listitem>
                 <listitem><para>
-                    <emphasis>Create the kernel recipe append file</emphasis>:
+                    <emphasis>Create the Kernel Recipe Append File</emphasis>:
                     Move to the
                     <filename>meta-mylayer/recipes-kernel/linux</filename>
                     directory and create the kernel's append file.
@@ -537,9 +540,9 @@
                     <literallayout class='monospaced'>
      FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
 
-     SRC_URI += "file://<replaceable>patch-file-one</replaceable>"
-     SRC_URI += "file://<replaceable>patch-file-two</replaceable>"
-     SRC_URI += "file://<replaceable>patch-file-three</replaceable>"
+     SRC_URI_append += "file://<replaceable>patch-file-one</replaceable>"
+     SRC_URI_append += "file://<replaceable>patch-file-two</replaceable>"
+     SRC_URI_append += "file://<replaceable>patch-file-three</replaceable>"
                     </literallayout>
                     The
                     <ulink 
url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink>