summaryrefslogtreecommitdiffstats
path: root/bitbake/doc
diff options
context:
space:
mode:
Diffstat (limited to 'bitbake/doc')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml34
1 files changed, 34 insertions, 0 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 646f6744e6..857f8b279c 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml
@@ -1670,6 +1670,40 @@
1670 task. 1670 task.
1671 And, the <filename>do_build</filename> depends on the completion 1671 And, the <filename>do_build</filename> depends on the completion
1672 of the <filename>printdate</filename> task. 1672 of the <filename>printdate</filename> task.
1673 <note>
1674 Recipes are built by having their
1675 <filename>do_build</filename> (not to be confused with
1676 <filename>do_compile</filename>) tasks executed.
1677 For a task to run when a recipe is built, the task must
1678 therefore be a direct or indirect dependency of
1679 <filename>do_build</filename>.
1680 For illustration, here are some examples:
1681 <itemizedlist>
1682 <listitem><para>
1683 The directive
1684 <filename>addtask mytask before do_build</filename>
1685 causes <filename>mytask</filename> to run when the
1686 recipe is built.
1687 In this example, <filename>mytask</filename> is run
1688 at an unspecified time relative to other tasks within
1689 the recipe, since "after" is not used.
1690 </para></listitem>
1691 <listitem><para>
1692 The directive
1693 <filename>addtask mytask after do_configure</filename>
1694 by itself does not cause <filename>mytask</filename>
1695 to run when the recipe is built.
1696 The task can still be run manually using the following:
1697 <literallayout class='monospaced'>
1698 $ bitbake <replaceable>recipe</replaceable> -c mytask
1699 </literallayout>
1700 <filename>mytask</filename> could also be declared as
1701 a dependency of some other task.
1702 Regardless, the task is run after
1703 <filename>do_configure</filename>.
1704 </para></listitem>
1705 </itemizedlist>
1706 </note>
1673 </para> 1707 </para>
1674 </section> 1708 </section>
1675 1709