[gnome-continuous-yocto/gnomeostree-3.28-rocko: 2998/8267] bitbake: bitbake-user-manual: Updated the [noexec] and [nostamp] flag descriptions

[Emmanuele Bassi <ebassi src gnome org>]

commit ce70355260ea0cb0c569706356d60aca2bcf15af
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Oct 10 12:49:06 2016 -0700

    bitbake: bitbake-user-manual: Updated the [noexec] and [nostamp] flag descriptions
    
    Fixes [YOCTO #10401]
    
    Added some wording to clarify that setting these flags to "1"
    causes the desired action.  Also, provided a cautionary note
    about tasks depending on any [nostamp] task causes the task
    to always be executed and could cause unnecessary rebuild time.
    
    (Bitbake rev: b6a4a6147b9e455cc1fec37553fb577f187a2d73)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 .../bitbake-user-manual-metadata.xml               |   17 +++++++++++++----
 1 files changed, 13 insertions(+), 4 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 e1b2f2d..fac54d3 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -1833,14 +1833,23 @@
                      exclusion.
                     </para></listitem>
                 <listitem><para><emphasis><filename>[noexec]</filename>:</emphasis>
-                    Marks the tasks as being empty and no execution required.
-                    The <filename>[noexec]</filename> flag can be used to set up
+                    When set to "1", marks the task as being empty, with
+                    no execution required.
+                    You can use the <filename>[noexec]</filename> flag to set up
                     tasks as dependency placeholders, or to disable tasks defined
                     elsewhere that are not needed in a particular recipe.
                     </para></listitem>
                 <listitem><para><emphasis><filename>[nostamp]</filename>:</emphasis>
-                    Tells BitBake to not generate a stamp file for a task,
-                    which implies the task should always be executed.
+                    When set to "1", tells BitBake to not generate a stamp
+                    file for a task, which implies the task should always
+                    be executed.
+                    <note><title>Caution</title>
+                        Any task that depends (possibly indirectly) on a
+                        <filename>[nostamp]</filename> task will always be
+                        executed as well.
+                        This can cause unnecessary rebuilding if you are
+                        not careful.
+                    </note>
                     </para></listitem>
                 <listitem><para><emphasis><filename>[postfuncs]</filename>:</emphasis>
                     List of functions to call after the completion of the task.