diff --git a/documentation/ref-manual/ref-tasks.xml b/documentation/ref-manual/ref-tasks.xml index d6d287b435..fc23a7ba0d 100644 --- a/documentation/ref-manual/ref-tasks.xml +++ b/documentation/ref-manual/ref-tasks.xml @@ -77,6 +77,14 @@ DEPLOYDIR variable. + + + The do_deploy task is a + shared state (sstate) task, which means that the task can + be accelerated through sstate use. + Realize also that if the task is re-executed, any previous output + is removed (i.e. "cleaned"). +
@@ -210,6 +218,14 @@ task into the sysroot in order to make them available to other recipes. + + + The do_populate_sysroot task is a + shared state (sstate) task, which means that the task can + be accelerated through sstate use. + Realize also that if the task is re-executed, any previous output + is removed (i.e. "cleaned"). +
@@ -321,7 +337,8 @@ Removes all output files, shared state (sstate) cache, and - downloaded source files for a target. + downloaded source files for a target (i.e. the contents of + DL_DIR). Essentially, the do_cleanall task is identical to the do_cleansstate @@ -366,10 +383,19 @@ - When you run the do_cleanstate task, + When you run the do_cleansstate task, the OpenEmbedded build system no longer uses any sstate. Consequently, building the recipe from scratch is guaranteed. + + The do_cleansstate task cannot remove + sstate from a remote sstate mirror. + If you need to build a target from scratch using remote + mirrors, use the "-f" option as follows: + + $ bitbake -f -c do_cleansstate <target> + +