[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1481/8267] bitbake: bitbake-user-manual: Updated dependency section for tasks

[Emmanuele Bassi <ebassi src gnome org>]

commit d918df7e8e6adc022a261608242b5750859a0bbc
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Jul 11 14:24:22 2016 -0700

    bitbake: bitbake-user-manual: Updated dependency section for tasks
    
    Fixes [YOCTO #9861]
    
    I updated the section on dependencies to give a couple of examples
    for task dependencies within a single recipe and dependencies for
    tasks between two individual recipes.
    
    (Bitbake rev: 231deeb2b0b3847cba971ca30c16e29357100ae6)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 .../bitbake-user-manual-metadata.xml               |   35 ++++++++++++++-----
 1 files changed, 26 insertions(+), 9 deletions(-)
---
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml 
b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
index 26fe58f..646f674 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -1624,15 +1624,32 @@
         <title>Dependencies</title>
 
         <para>
-            To allow for efficient operation given multiple processes
-            executing in parallel, BitBake handles dependencies at
-            the task level.
-            BitBake supports a robust method to handle these dependencies.
-        </para>
-
-        <para>
-            This section describes several types of dependency mechanisms.
-        </para>
+            To allow for efficient parallel processing, BitBake handles
+            dependencies at the task level.
+            Dependencies can exist both between tasks within a single recipe
+            and between tasks in different recipes.
+            Following are examples of each:
+            <itemizedlist>
+                <listitem><para>For tasks within a single recipe, a
+                    recipe's <filename>do_configure</filename>
+                    task might need to complete before its
+                    <filename>do_compile</filename> task can run.
+                    </para></listitem>
+                <listitem><para>For tasks in different recipes, one
+                    recipe's <filename>do_configure</filename>
+                    task might require another recipe's
+                    <filename>do_populate_sysroot</filename>
+                    task to finish first such that the libraries and headers
+                    provided by the other recipe are available.
+                    </para></listitem>
+             </itemizedlist>
+         </para>
+
+         <para>
+             This section describes several ways to declare dependencies.
+             Remember, even though dependencies are declared in different ways, they
+             are all simply dependencies between tasks.
+         </para>
 
         <section id='dependencies-internal-to-the-bb-file'>
             <title>Dependencies Internal to the <filename>.bb</filename> File</title>