[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1661/8267] ref-manual: Applied review changes to the do_deploy task.

[Emmanuele Bassi <ebassi src gnome org>]

commit 7c5a1471412634b3eb1279e2db45d46dc55fe0f2
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Tue Jul 19 11:37:00 2016 -0700

    ref-manual: Applied review changes to the do_deploy task.
    
    Cleared up the last third of the description with better structure
    and wording.
    
    Fixes [YOCTO #9970]
    
    (From yocto-docs rev: a2dbea4f3bbdddd72c86a5ade86ac822cd9bfecd)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-tasks.xml |   31 +++++++++++++++++++------------
 1 files changed, 19 insertions(+), 12 deletions(-)
---
diff --git a/documentation/ref-manual/ref-tasks.xml b/documentation/ref-manual/ref-tasks.xml
index 572740e..d180eee 100644
--- a/documentation/ref-manual/ref-tasks.xml
+++ b/documentation/ref-manual/ref-tasks.xml
@@ -158,22 +158,29 @@
         </para>
 
         <para>
-            The <filename>do_deploy</filename> task is not added as a task by
-            default and needs to be added manually.
-            You can add this task using the following:
+            The <filename>do_deploy</filename> task is not added as a task
+            by default and consequently needs to be added manually.
+            If you want the task to run after
+            <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>,
+            you can add it by doing the following:
             <literallayout class='monospaced'>
      addtask deploy after do_compile
             </literallayout>
-            If the <filename>do_deploy</filename> should run some time after
-            the <filename>do_compile</filename>, the
-            <filename>base.bbclass</filename> has the following to ensure that
-            all <filename>do_deploy</filename> tasks run by default.
-            See the
-            "<ulink url='&YOCTO_DOCS_BB_URL;#dependencies'>Dependencies</ulink>"
-            section in the BitBake User Manual for more information.
-            <literallayout class='monospaced'>
+            Adding <filename>do_deploy</filename> after other tasks works the
+            same way.
+            <note>
+                You do not need to add <filename>before do_build</filename>
+                to the <filename>addtask</filename> command (though it is
+                harmless), because the
+                <link linkend='ref-classes-base'><filename>base</filename></link>
+                class contains the following:
+                <literallayout class='monospaced'>
      do_build[recrdeptask] += "do_deploy"
-            </literallayout>
+                </literallayout>
+                See the
+                "<ulink url='&YOCTO_DOCS_BB_URL;#dependencies'>Dependencies</ulink>"
+                section in the BitBake User Manual for more information.
+            </note>
         </para>
 
         <para>