remap=tt>poolm <gopt><topt> [ -p pool ]* ( -prune | -remove | -rm ) [ -expr <expr> ]
Pruning or removing packages from pools is done by the execution of the backend action with the name pool_remove. A typical definition for pool_remove is
pool_remove = "rm -rf {POOL_PackagePath}";
This will remove the current version directory for the
current package in the pool including derived files for
all
target-platform-configurations. If not all of the
TPCs you use are usually kept at the same build state,
you might prefer the following definition which deletes
only the derived files for one
TPC.
pool_remove = "rm -rf {POOL_PackageDerivedPath}";
You may of course specify any command to be executed as remove action, but we would advise you to keep the intended semantics.
It is always a good idea to test the selection expression you want to use with the remove action first with the -list option, to see which packages and versions will actually be affected. You do probably not want to execute something like poolm -rm, as this will erase all the packages from your local package pool.
The expressions used to select the pools are the same as in the -list command and described in detail in Section 4.2.