From ea256df2a8af386f5c8c7bc7744d6d790ab0a3f9 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Wed, 30 Aug 2017 13:34:52 -0700
Subject: dev-manual, kernel-dev: Working kernel flow process using devtool

A work-in-progress of an example that modifies the kernel
using the devtool.  The procedure is not complete yet as it
does not run properly.

(From yocto-docs rev: 462ba2e46f237c294f05805ad5044291a085975d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/kernel-dev/kernel-dev-intro.xml | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

(limited to 'documentation/kernel-dev/kernel-dev-intro.xml')

diff --git a/documentation/kernel-dev/kernel-dev-intro.xml b/documentation/kernel-dev/kernel-dev-intro.xml
index a2644aaa13..ce8e0fcb6d 100644
--- a/documentation/kernel-dev/kernel-dev-intro.xml
+++ b/documentation/kernel-dev/kernel-dev-intro.xml
@@ -108,6 +108,16 @@
         "<ulink url='&YOCTO_DOCS_DEV_URL;#cloning-the-poky-repository'>Cloning the <filename>poky</filename> Repository</ulink>"
         section in the Yocto Project Development Manual to set up your
         Source Directory.
+        <note>
+            Be sure you check out the appropriate development branch or
+            by tag to get the version of Yocto Project you want.
+            See the
+            "<ulink url='&YOCTO_DOCS_DEV_URL;#checking-out-by-branch-in-poky'>Checking Out by Branch in Poky</ulink>"
+            and
+            "<ulink url='&YOCTO_DOCS_DEV_URL;#checkout-out-by-tag-in-poky'>Checking Out by Tag in Poky</ulink>"
+            sections in the Yocto Project Development Manual for more
+            information.
+        </note>
     </para>
 
     <para>
@@ -156,7 +166,7 @@
                     building for the QEMU emulator in 32-bit mode.
                     However, if you are not, you need to set the
                     <filename>MACHINE</filename> variable appropriately in
-                    your <filename>local.conf</filename> file found in the
+                    your <filename>conf/local.conf</filename> file found in the
                     <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>
                     (i.e. <filename>~/poky/build</filename> in this example).
                     </para>
@@ -208,6 +218,7 @@
                     Use BitBake to build the extensible SDK specifically for
                     the Minnowboard:
                     <literallayout class='monospaced'>
+     $ cd ~/poky/build
      $ bitbake core-image-minimal -c populate_sdk_ext
                     </literallayout>
                     Once the build finishes, you can find the SDK installer
@@ -290,12 +301,9 @@
                     If you were building for actual hardware and not for
                     emulation, you could flash the image to a USB stick
                     on <filename>/dev/sdd</filename> and boot your device.
-                    Use a command similar to the following command to flash
-                    the image:
-                    <literallayout class='monospaced'>
-     $ sudo dd if=tmp/deploy/images/<replaceable>architecture</replaceable>/core-image-minimal-<replaceable>architecture</replaceable>.wic of=/dev/sdd bs=1MB
-     $ sync
-                    </literallayout>
+                    For an example that uses a Minnowboard, see the
+                    <ulink url='https://wiki.yoctoproject.org/wiki/TipsAndTricks/KernelDevelopmentWithEsdk'>TipsAndTricks/KernelDevelopmentWithEsdk</ulink>
+                    Wiki page.
                     </para></listitem>
             </orderedlist>
         </para>
-- 
cgit v1.2.3-54-g00ecf