[Python-Dev] Silent deprecation

Guido van Rossum guido@python.org
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
deprecated features.

--Guido van Rossum (home page: http://www.python.org/~guido/)