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>
+
+