diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2016-10-10 12:49:06 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2016-10-13 23:29:25 +0100 |
commit | ce70355260ea0cb0c569706356d60aca2bcf15af (patch) | |
tree | 800a88dd5097b1253c7b6281d8a823cc82c5cef9 /bitbake/doc | |
parent | 1d4031a4dfc3fe633479bb66f97b713be433b49a (diff) | |
download | openembedded-core-contrib-ce70355260ea0cb0c569706356d60aca2bcf15af.tar.gz |
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>
Diffstat (limited to 'bitbake/doc')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/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 e1b2f2d0b2..fac54d34d3 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. |