Today I wanted to put the proper deprecation stuff into a function which
should be deprecated, and I had to grep through source code to find the
proper way to do it. Perhaps there should be a section in the
developer's guide briefly describing the correct way to do this, and how
to change doctests appropriately?
--- Dan Drake
That ticket contains what I know, which is not necessarily the
"official" correct way! Anyone who knows more about how this should be
done should comment on the ticket.
- #7515 Improved deprecation and renaming of function and methods
And the followup:
- #7559 replace all the deprecation warning using
deprecated_function_alias whenever possible
- #8073 deprecation version number should say "After version ..."