On Wed, Sep 24, 2014 at 7:54 AM, Nathann Cohen <[email protected]> wrote:
> Hello everybody !
>
> Here I was deprecating stuff, and I wondered: could we make it explicit in
> the tab-completion that some functions are deprecated ?
>
> In particular, I have to (I am not proud) replace a (now deprecated)
> designs.orthogonal_array with a (note the terminal 's')
> designs.orthogonal_arrays.
>
> Wouldn't it be cool if typing "designs.<tab>" would display the first
> deprecated function in light gray, so as to mean "it's disappearing" ?
>
> I was wondering how to prevent users from reading the (long) documentation
> of this function before noticing that it is deprecated when they call it,
> only to see how the new one works.

Maybe you could write at the TOP of the docstring:

   DEPRECATED

Or even make the deprecation decorator prepend that to the docstring
automatically?

>
> Clearly not critical :-P



>
> Nathann
>
> --
> You received this message because you are subscribed to the Google Groups
> "sage-devel" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at http://groups.google.com/group/sage-devel.
> For more options, visit https://groups.google.com/d/optout.



-- 
William Stein
Professor of Mathematics
University of Washington
http://wstein.org
[email protected]

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to