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 3d9234cba6..5df00050ce 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml @@ -1848,44 +1848,48 @@ addtask printdate after do_fetch before do_build - In this example, the printdate task is - depends on the completion of the do_fetch + In this example, the do_printdate + task depends on the completion of the + do_fetch task, and the + do_build task depends on the + completion of the do_printdate task. - And, the do_build depends on the completion - of the printdate task. - - Recipes are built by having their - do_build (not to be confused with - do_compile) tasks executed. - For a task to run when a recipe is built, the task must - therefore be a direct or indirect dependency of - do_build. - For illustration, here are some examples: + + For a task to run, it must be a direct or indirect + dependency of some other task that is scheduled to + run. + + For illustration, here are some examples: The directive - addtask mytask before do_build - causes mytask to run when the - recipe is built. - In this example, mytask is run - at an unspecified time relative to other tasks within - the recipe, since after is not used. + addtask mytask before do_configure + causes do_mytask to run before + do_configure runs. + Be aware that do_mytask still only + runs if its input checksum + has changed since the last time it was run. + Changes to the input checksum of + do_mytask also indirectly cause + do_configure to run. The directive addtask mytask after do_configure - by itself does not cause mytask - to run when the recipe is built. - The task can still be run manually using the following: + by itself never causes do_mytask + to run. + do_mytask can still be run manually + as follows: $ bitbake recipe -c mytask - mytask could also be declared as - a dependency of some other task. - Regardless, the task is run after + Declaring do_mytask as a dependency + of some other task that is scheduled to run also causes + it to run. + Regardless, the task runs after do_configure. - +