diff --git a/documentation/sdk-manual/sdk-extensible.xml b/documentation/sdk-manual/sdk-extensible.xml
index 8f64745d52..bb51683a44 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.