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

Reply via email to