[Python-Dev] Silent deprecation
Guido van Rossum
Wed, 29 May 2002 11:44:37 -0400
> Note: there's an patch available at http://python.org/sf/561928
Thanks! I agree with the name change to PendingDeprecationWarning.
Check it in before I change my mind! :-)
> Guido van Rossum wrote:
> > I think we can do two things. Either we can keep the docs for
> > deprecated features but clearly mark the chapter or section with a
> > deprecation note at the start, in bold.
> > Or we can remove the docs for deprecated features, and add a chapter
> > "deprecated features" which mentions each deprecated feature without
> > describing it in detail, and provides information about what to use
> > instead.
> Either of these approaches works for me.
I personally like the second version better -- by not providing full
documentation, it discourages new users more strongly from using
--Guido van Rossum (home page: http://www.python.org/~guido/)