On Mon, Jun 11, 2012 at 1:54 AM, John Cremona <john.crem...@gmail.com> wrote: > On 11 June 2012 03:38, William Stein <wst...@gmail.com> wrote: >> On Sun, Jun 10, 2012 at 4:31 PM, Volker Braun <vbraun.n...@gmail.com> wrote: >>> Keeping the deprecation wiki, trac, and the Sage library in sync seems >>> hopeless. How about we >>> >>> a) add the ticket where it was introduced as an argument to the >>> deprecation(msg, sage_version, trac_number) >>> b) document this in the developer manual >> >> +1 -- that's a viable proposal. >> > > +1 > > I guess the new trac_number field will have to default to None, unless > we want to raise a deprecation warning whenever deprecation() is only > called with two arguments...infiinte loop?! > > I count about 132 times where deprecation is imported and about 70 > times where deprecation() is called. Roughly.
I would just suggest: deprecation(msg,trac_number) 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. In my opinion this (Volker's suggestion) is a brilliant solution to this problem. William -- William > > John >>> >>> >>> >>> On Sunday, June 10, 2012 10:40:36 PM UTC+1, Keshav Kini wrote: >>>> >>>> Volker Braun <vbraun.n...@gmail.com> writes: >>>> >>>> > Instead of designing a process to ensure that the deprecation version is >>>> > absolutely correct we should spend some effort to timely review tickets >>>> > :-P >>>> >>>> While that is an admirable goal, maybe the best way to handle this is to >>>> create a wiki page listing deprecations and what release of Sage they >>>> were introduced in, as I suggested on sage-devel many months ago [1], as >>>> I recall :P I would have done it myself but apparently I forgot about >>>> it... >>>> >>>> [1] http://thread.gmane.org/gmane.comp.mathematics.sage.devel/53717 >>>> >>>> -Keshav >>>> >>>> ---- >>>> Join us in #sagemath on irc.freenode.net ! >>>> >>> -- >>> 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 >> >> >> >> -- >> William Stein >> Professor of Mathematics >> University of Washington >> http://wstein.org >> >> -- >> 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 > > -- > 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 -- William Stein Professor of Mathematics University of Washington http://wstein.org -- 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