[gnome-continuous-yocto/gnomeostree-3.28-rocko: 2647/8267] sdk-manual: Updates to the devtool Finish command flow.

[Emmanuele Bassi <ebassi src gnome org>]

commit 0c823cce36536688eae27e2080626f7ad997813d
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Fri Sep 16 08:53:47 2016 -0700

    sdk-manual: Updates to the devtool Finish command flow.
    
    (From yocto-docs rev: f980b7cfa021c3777acd8e26b00cf40ed58f10f4)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/sdk-manual/sdk-extensible.xml |   17 +++++++----------
 1 files changed, 7 insertions(+), 10 deletions(-)
---
diff --git a/documentation/sdk-manual/sdk-extensible.xml b/documentation/sdk-manual/sdk-extensible.xml
index 8f64745..bb51683 100644
--- a/documentation/sdk-manual/sdk-extensible.xml
+++ b/documentation/sdk-manual/sdk-extensible.xml
@@ -352,10 +352,7 @@
                     built normally rather than from the workspace.
                     <literallayout class='monospaced'>
      $ devtool finish <replaceable>recipe layer</replaceable>
-                    </literallayout></para>
-
-                    <para>Part of the <filename>devtool finish</filename>
-                    command converts commits created using Git to patch files.
+                    </literallayout>
                     <note>
                         Any changes you want to turn into patches must be
                         committed to the Git repository in the source tree.
@@ -571,14 +568,14 @@
                     <emphasis>Finish Your Work With the Recipe</emphasis>:
                     The <filename>devtool finish</filename> command creates
                     any patches corresponding to commits in the local
-                    Git repository and then resets the recipe so that the
-                    recipe is built normally rather than from the workspace.
+                    Git repository, updates the recipe to point to them
+                    (or creates a <filename>.bbappend</filename> file to do
+                    so, depending on the specified destination layer), and
+                    then resets the recipe so that the recipe is built normally
+                    rather than from the workspace.
                     <literallayout class='monospaced'>
      $ devtool finish <replaceable>recipe layer</replaceable>
-                    </literallayout></para>
-
-                    <para>Part of the <filename>devtool finish</filename>
-                    command converts commits created using Git to patch files.
+                    </literallayout>
                     <note>
                         Any changes you want to turn into patches must be
                         committed to the Git repository in the source tree.