Update upgrade.rst

Added docs for the new function: clean()