def new_func_with_deprecation():
pass<EOL>
This is the summary. The deprecate directive goes next.

.. deprecated:: 1.0
    Use new_func instead.

This is the extended summary. The deprecate directive goes before this.