diff options
author | Luca Ceresoli <luca.ceresoli@bootlin.com> | 2024-02-28 12:25:14 +0100 |
---|---|---|
committer | Steve Sakoman <steve@sakoman.com> | 2024-03-16 08:33:21 -1000 |
commit | 05fc0002721ed1bed8031d90ba27e0669412f1c0 (patch) | |
tree | 14c1b98ecf109a07164d23835b4b45c3ee610fc8 /documentation/conf.py | |
parent | c9834bf620885c0570e68187f270aa29dc81af9f (diff) | |
download | poky-05fc0002721ed1bed8031d90ba27e0669412f1c0.tar.gz |
ref-manual: tasks: do_cleanall: recommend using '-f' instead
do_cleanall can produce failures when used in legitimate cases, such as
with recipe variants (foo and foo-native) or a shared DL_DIR. This is why
it is forbidden when writing tests that will run on the autobuilders
(https://docs.yoctoproject.org/test-manual/intro.html?highlight=cleanall#considerations-when-writing-tests).
Reword the documentation to clearly discourage, provide a safe alternative
(bitbake -f -c fetch), and the rationale with an example.
Reported-by: Sam Liddicott
Link: https://bootlin.com/blog/yocto-sharing-the-sstate-cache-and-download-directories/#comment-2650335
(From yocto-docs rev: c8ba32df7576ceb4b8371595e14ad51bdb3e33b1)
Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
Reviewed-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
Diffstat (limited to 'documentation/conf.py')
0 files changed, 0 insertions, 0 deletions