[oe-commits] [bitbake] 03/05: bitbake-user-manual: Updated the [noexec] and [nostamp] flag descriptions

[git at git.openembedded.org]

rpurdie pushed a commit to branch 1.32
in repository bitbake.

commit b6a4a6147b9e455cc1fec37553fb577f187a2d73
Author: Scott Rifenbark <srifenbark at gmail.com>
AuthorDate: Mon Oct 10 12:49:06 2016 -0700

    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.
    
    Signed-off-by: Scott Rifenbark <srifenbark at gmail.com>
---
 .../bitbake-user-manual-metadata.xml                    | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
index e1b2f2d..fac54d3 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/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.

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.