summaryrefslogtreecommitdiffstats
path: root/bitbake/doc
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-10-10 12:49:06 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-10-13 23:29:25 +0100
commitce70355260ea0cb0c569706356d60aca2bcf15af (patch)
tree800a88dd5097b1253c7b6281d8a823cc82c5cef9 /bitbake/doc
parent1d4031a4dfc3fe633479bb66f97b713be433b49a (diff)
downloadpoky-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.xml17
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 @@
1833 exclusion. 1833 exclusion.
1834 </para></listitem> 1834 </para></listitem>
1835 <listitem><para><emphasis><filename>[noexec]</filename>:</emphasis> 1835 <listitem><para><emphasis><filename>[noexec]</filename>:</emphasis>
1836 Marks the tasks as being empty and no execution required. 1836 When set to "1", marks the task as being empty, with
1837 The <filename>[noexec]</filename> flag can be used to set up 1837 no execution required.
1838 You can use the <filename>[noexec]</filename> flag to set up
1838 tasks as dependency placeholders, or to disable tasks defined 1839 tasks as dependency placeholders, or to disable tasks defined
1839 elsewhere that are not needed in a particular recipe. 1840 elsewhere that are not needed in a particular recipe.
1840 </para></listitem> 1841 </para></listitem>
1841 <listitem><para><emphasis><filename>[nostamp]</filename>:</emphasis> 1842 <listitem><para><emphasis><filename>[nostamp]</filename>:</emphasis>
1842 Tells BitBake to not generate a stamp file for a task, 1843 When set to "1", tells BitBake to not generate a stamp
1843 which implies the task should always be executed. 1844 file for a task, which implies the task should always
1845 be executed.
1846 <note><title>Caution</title>
1847 Any task that depends (possibly indirectly) on a
1848 <filename>[nostamp]</filename> task will always be
1849 executed as well.
1850 This can cause unnecessary rebuilding if you are
1851 not careful.
1852 </note>
1844 </para></listitem> 1853 </para></listitem>
1845 <listitem><para><emphasis><filename>[postfuncs]</filename>:</emphasis> 1854 <listitem><para><emphasis><filename>[postfuncs]</filename>:</emphasis>
1846 List of functions to call after the completion of the task. 1855 List of functions to call after the completion of the task.