As discussed on https://groups.google.com/d/topic/sage-devel/I12IeaFlE7g/discussion, change the deprecation function to the new arguments

deprecation(trac_number, message) 

where both arguments are mandatory. Once this code is in Sage, one
can deduce every possible thing discussed above in this thread from
the trac number. The deprecation warning can produce the URL of the
trac ticket.

Analogous changes are made to deprecated_function_alias and deprecated_callable_import. Finally, the @rename_keyword(deprecated="sage version string", ...) decorator is changed to

@rename_keyword(deprecation=<trac_number>, ...)

Apply

• attachment: trac_13109_deprecation.patch
• attachment: trac_13109_ticket_numbers.patch
• attachment: trac_13109_fix_doctests.patch
• attachment: trac_13109-documentation.v3.patch

This ticket also fixes #8073, #8546.

Depends on #12544
Depends on #12965

CC: @JohnCremona @kini @williamstein @jasongrout @kcrisman

Component: doctest coverage

Author: Volker Braun

Reviewer: John Palmieri, Karl-Dieter Crisman

Merged: sage-5.2.rc0

Issue created by migration from https://trac.sagemath.org/ticket/13109