Improve deprecation warning decorator.
Improve deprecation warning decorator.

Add a new keyword `new_name` which allows to refer to a new function.

Improve the formatting of the `DeprecationWarning` message.

Append a warning to the docstring. The warning is formatted in
restructured text and interpreted by Sphinx.

atmtools/typhon,atmtools/typhon