[Python-Dev] Re: Deprecating divmod() // % for complex

Fred L. Drake, Jr. fdrake@acm.org
Mon, 15 Apr 2002 10:51:40 -0400

Guido van Rossum writes:
 > Unclear what the value is.  Deprecations are systematically listed in
 > the documentation AFAIK.

If that were the only issue, what's the point of maintaining a list in
the PEP at all?

I've heard requests that the deprecations be more easily located as
part of the documentation, so that there's an actual list of all
deprecations as a distinct section.  There's a fair bit of merit in
that, I think.  At the moment, the PEP is the closest thing we have to
that list.

Generating a list of deprecations from the markup elsewhere in the
documention shouldn't be too hard, and we could include a section in
the "What's New" document for new deprecations easily enough.


Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation