Right now, the deprecation function (for giving deprecation warnings)
has an option to say when the deprecation took effect. Because of the
way release numbers are decided, and because patches can be delayed
getting in, saying when a deprecation took place is very hard, if not
practically impossible.
Here is the current way of invoking this:
sage.misc.misc.deprecation("The function bar is removed.",
since='Sage Version 4.2')
How about we define a special string to use in a patch committing code
to Sage, so the invocation would be given in a patch as:
sage.misc.misc.deprecation("The function bar is removed.",
since=SAGE_NEXT_VERSION_FOR_DEPRECATION)
or something. Then as one of the steps in the release process, after
all patches have been merged in, replacing all such strings with the new
release version number.
Then the deprecations would actually reflect what release they started
in. In fact, we could replace that marker with the release number and
the date to help people even more.
Thanks,
Jason
--
To post to this group, send an email to sage-devel@googlegroups.com
To unsubscribe from this group, send an email to
sage-devel+unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org