add: improved description of the cleanup semantics.
chg: improved documentation.