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

Reply via email to