From 0767740f3289b41e02fd559aa24c6e35d90d3450 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Wed, 20 Sep 2017 12:27:22 -0700
Subject: [PATCH] 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>
---
 .../kernel-dev/kernel-dev-common.xml          | 29 ++++++++++---------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml
index 24feb94b796..6179883c488 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>
-- 
2.47.3