Clean up the discussion of the removal of modules based on PEP 4 or

documentation (a discrepency that will hopefully get fixed soon).  Part of the
clean up is to no longer explicitly list modules slated for removal that are
mentioned in PEP 4 so as to not keep a duplicate copy of that list.
This commit is contained in:
Brett Cannon 2007-01-10 19:30:05 +00:00
parent c177794044
commit ea3b5e5b64
1 changed files with 30 additions and 39 deletions

View File

@ -54,29 +54,28 @@ period.
Previously deprecated
---------------------
Modules in this section have been deprecated at some point in the
Python 2.x release series but are currently still distributed with
Python. Deprecation information is gathered either from PEP 4 or the
Global Module Index [#pep-0004]_, [#module-index]_. Each module is
listed with the Python version of initial deprecation.
PEP 4 lists all modules that have been deprecated in the stdlib
[#pep-0004]_. All modules listed in the PEP at the time of the first
alpha release of Python 3.0 will be removed.
============== ==========
Module Deprecated
============== ==========
buildtools 2.3
cfmfile 2.4
gopherlib 2.5
macfs 2.3
md5 2.5
mimetools 2.3
MimeWriter 2.3
mimefy 2.3
multifile 2.3
posixfile 1.5
rfc822 2.3
rgbimg 2.5
sha 2.5
============== ==========
The entire contents of libold will also be removed. These modules
have already been removed from being imported but are kept in the
distribution for Python for users that rely upon the code.
On top of the modules listed in PEP 4, other modules have been
documented as deprecated but have yet to be added to PEP 4.
============== ==========
Module Deprecated
============== ==========
buildtools 2.3
cfmfile 2.4
macfs 2.3
md5 2.5
sha 2.5
strop unknown
xmllib unknown
============== ==========
Platform-specific with minimal use
@ -134,13 +133,6 @@ their maintenance.
- Third-party libraries provide better support
(Python Imaging Library [#pil]_).
+ sv
- Wrapper for Indigo video card.
- Harware is no longer manufactured.
- Undocumented.
- Code not uniquely edited in 13 years.
* Solaris
+ SUNAUDIODEV/sunaudiodev
@ -228,6 +220,13 @@ or because the audience for the code is very small.
+ String slicing and string interpolation can do similar work.
+ Used by pdb, but do not need to expose API.
* stringold
+ Function versions of the methods on string objects.
+ Obsolete since Python 1.6.
+ Any functionality not in the string object or module will be moved
to the string module (mostly constants).
* symtable/_symtable
+ Undocumented.
@ -246,6 +245,8 @@ or because the audience for the code is very small.
+ Just a rebinding of names from the 'types' module.
+ Can also call ``type`` built-in to get most types easily.
+ Docstring states the module is no longer useful as of revision
27241 (2002-06-15).
* pure
@ -312,11 +313,6 @@ for what the module is meant for.
+ ``os.statvfs`` now returns a tuple with attributes.
* strop
+ Implements functions used by 'string' module that have now
become methods on the str type.
* thread
+ People should use 'threading' instead.
@ -328,11 +324,6 @@ for what the module is meant for.
+ Guido has previously supported the deprecation
[#thread-deprecation]_.
* timing
+ Use timeit or time.
+ Documentation says the module is obsolete [#timing-module]_.
Modules to Rename
=================