clean

This tasks cleans, i.e. removes, all artifacts that have been build by other tasks. In addition to that, the directory set by the parameter TARGET will be removed.

The task does not actually remove any built artifacts itself. It uses the -c (or --clean) option of all tasks that do build artifacts. By convention, these are tasks whose name starts with build- or compile-.

So clean will lookup the loaded task map, find all tasks that start with build- or compile- and execute them with the --clean option. If any of these tasks fails (for instance due to missing parameters), clean will also fail.

Options

The option simulate can be used to simulate a clean. Here, not task will be executed and the directory TARGET will not be removed either. Instead, the task will simply print what commands it would run.

The default command to remove the TARGET directory is rm -frI. This is an additional safety feature to prevent accidental removal of the directory. The option force can be used to remove the directory forced, i.e. using rm -fr instead. simulate will overwrite force.

-f | --force       force mode, not questions asked
-h | --help        print help screen and exit
-s | --simulate    print only, removes nothing, overwrites force