Clarifying when lb clean --purge is needed.
authorBen Armstrong <synrg@debian.org>
Wed, 20 Nov 2013 15:29:24 +0000 (11:29 -0400)
committerBen Armstrong <synrg@debian.org>
Wed, 20 Nov 2013 15:29:24 +0000 (11:29 -0400)
manual/en/user_overview.ssi

index 4c1dfae..6fc9084 100644 (file)
@@ -67,7 +67,7 @@ The #{lb build}# command reads in your configuration from the #{config/}# direct
 
 3~lb-clean The #{lb clean}# command
 
-It is the job of the #{lb clean}# command to remove various parts of a build so subsequent builds can start from a clean state. By default, #{chroot}#, #{binary}# and #{source}# stages are cleaned, but the cache is left intact. Also, individual stages can be cleaned. For example, if you have made changes that only affect the binary stage, use #{lb clean --binary}# prior to building a new binary. See the #{lb_clean}# man page for a full list of options.
+It is the job of the #{lb clean}# command to remove various parts of a build so subsequent builds can start from a clean state. By default, #{chroot}#, #{binary}# and #{source}# stages are cleaned, but the cache is left intact. Also, individual stages can be cleaned. For example, if you have made changes that only affect the binary stage, use #{lb clean --binary}# prior to building a new binary. If your changes invalidate the bootstrap and/or package caches, e.g. changes to --mode, --architecture, or --bootstrap, you must use #{lb clean --purge}#. See the #{lb_clean}# man page for a full list of options.
 
 2~live-boot The live-boot package