Clean up listing of what has been done for PEP 3108 to make it easier to find what has not been done.

This commit is contained in:
Brett Cannon 2008-08-17 20:51:56 +00:00
parent dce6a1ceec
commit a7c0ec55a3
1 changed files with 133 additions and 133 deletions

View File

@ -64,55 +64,55 @@ The entire contents of lib-old 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.
* cfmfile [done: 2.6, 3.0]
* cfmfile
+ Documented as deprecated since Python 2.4 without an explicit
reason.
* cl [done: 2.6, 3.0]
* cl
+ Documented as obsolete since Python 2.0 or earlier.
+ Interface to SGI hardware.
* md5 [done: 2.6, 3.0]
* md5
+ Supplanted by the ``hashlib`` module.
* mimetools [done: 2.6, 3.0]
* mimetools
+ Documented as obsolete in a previous version.
+ Supplanted by the ``email`` package.
* MimeWriter [done: 2.6, 3.0]
* MimeWriter
+ Supplanted by the ``email`` package.
* mimify [done: 2.6, 3.0]
* mimify
+ Supplanted by the ``email`` package.
* multifile [done: 2.6, 3.0]
* multifile
+ Supplanted by the ``email`` package.
* posixfile [done: 2.6, 3.0]
* posixfile
+ Locking is better done by ``fcntl.lockf()``.
* rfc822 [done: 2.6, 3.0]
* rfc822
+ Supplanted by the ``email`` package.
* sha [done: 2.6, 3.0]
* sha
+ Supplanted by the ``hashlib`` package.
* sv [done: 2.6, 3.0]
* sv
+ Documented as obsolete since Python 2.0 or earlier.
+ Interface to obsolete SGI Indigo hardware.
* timing [done: 2.6, 3.0]
* timing
+ Documented as obsolete since Python 2.0 or earlier.
+ ``time.clock()`` gives better time resolution.
@ -131,120 +131,120 @@ their maintenance.
The modules mentioned below are documented. All undocumented modules
for the specified platforms will also be removed.
IRIX [done]
IRIX
///////////
The IRIX operating system is no longer produced [#irix-retirement]_.
Removing all modules from the plat-irix[56] directory has been deemed
reasonable because of this fact.
+ AL/al [done: 2.6, 3.0]
+ AL/al
- Provides sound support on Indy and Indigo workstations.
- Both workstations are no longer available.
- Code has not been uniquely edited in three years.
+ cd/CD [done: 2.6, 3.0]
+ cd/CD
- CD drive control for SGI systems.
- SGI no longer sells machines with IRIX on them.
- Code has not been uniquely edited in 14 years.
+ cddb [done: 2.6, 3.0]
+ cddb
- Undocumented.
+ cdplayer [done: 2.6, 3.0]
+ cdplayer
- Undocumented.
+ cl/CL/CL_old [done: 2.6, 3.0]
+ cl/CL/CL_old
- Compression library for SGI systems.
- SGI no longer sells machines with IRIX on them.
- Code has not been uniquely edited in 14 years.
+ DEVICE/GL/gl/cgen/cgensuport [done: 2.6, 3.0]
+ DEVICE/GL/gl/cgen/cgensuport
- GL access, which is the predecessor to OpenGL.
- Has not been edited in at least eight years.
- Third-party libraries provide better support (PyOpenGL [#pyopengl]_).
+ ERRNO [done: 2.6, 3.0]
+ ERRNO
- Undocumented.
+ FILE [done: 2.6, 3.0]
+ FILE
- Undocumented.
+ FL/fl/flp [done: 2.6, 3.0]
+ FL/fl/flp
- Wrapper for the FORMS library [#irix-forms]_
- FORMS has not been edited in 12 years.
- Library is not widely used.
- First eight hits on Google are for Python docs for fl.
+ fm [done: 2.6, 3.0]
+ fm
- Wrapper to the IRIS Font Manager library.
- Only available on SGI machines which no longer come with IRIX.
+ GET [done: 2.6, 3.0]
+ GET
- Undocumented.
+ GLWS [done: 2.6, 3.0]
+ GLWS
- Undocumented.
+ imgfile [done: 2.6, 3.0]
+ imgfile
- Wrapper for SGI libimage library for imglib image files
(``.rgb`` files).
- Python Imaging Library provdes read-only support [#pil]_.
- Not uniquely edited in 13 years.
+ IN [done: 2.6, 3.0]
+ IN
- Undocumented.
+ IOCTL [done: 2.6, 3.0]
+ IOCTL
- Undocumented.
+ jpeg [done: 2.6, 3.0]
+ jpeg
- Wrapper for JPEG (de)compressor.
- Code not uniquely edited in nine years.
- Third-party libraries provide better support
(Python Imaging Library [#pil]_).
+ panel [done: 2.6, 3.0]
+ panel
- Undocumented.
+ panelparser [done: 2.6, 3.0]
+ panelparser
- Undocumented.
+ readcd [done: 2.6, 3.0]
+ readcd
- Undocumented.
+ SV [done: 2.6, 3.0]
+ SV
- Undocumented.
+ torgb [done: 2.6, 3.0]
+ torgb
- Undocumented.
+ WAIT [done: 2.6, 3.0]
+ WAIT
- Undocumented.
Mac-specific modules [done]
Mac-specific modules
////////////////////////////
The Mac-specific modules are not well-maintained (e.g., the bgen
@ -255,16 +255,16 @@ such a large amount of OS-specific modules. Thus all modules under
A stub module for proxy access will be provided for use by urllib.
* _builtinSuites [done: 2.6, 3.0]
* _builtinSuites
- Undocumented.
- Package under lib-scriptpackages.
* Audio_mac [done: 2.6, 3.0]
* Audio_mac
- Undocumented.
* aepack [done: 2.6, 3.0]
* aepack
- OSA support is better through third-party modules.
@ -273,164 +273,164 @@ A stub module for proxy access will be provided for use by urllib.
- Hard-coded endianness which breaks on Intel Macs.
- Might need to rename if Carbon package dependent.
* aetools [done: 2.6, 3.0]
* aetools
- See aepack.
* aetypes [done: 2.6, 3.0]
* aetypes
- See aepack.
* applesingle [done: 2.6, 3.0]
* applesingle
- Undocumented.
- AppleSingle is a binary file format for A/UX.
- A/UX no longer distributed.
* appletrawmain [done: 2.6, 3.0]
* appletrawmain
- Undocumented.
* appletrunner [done: 2.6, 3.0]
* appletrunner
- Undocumented.
* argvemulator [done: 2.6, 3.0]
* argvemulator
- Undocumented.
* autoGIL [done: 2.6, 3.0]
* autoGIL
- Very bad model for using Python with the CFRunLoop.
* bgenlocations [done: 2.6, 3.0]
* bgenlocations
- Undocumented.
* buildtools [done: 2.6, 3.0]
* buildtools
- Documented as deprecated since Python 2.3 without an explicit
reason.
* bundlebuilder [done: 2.6, 3.0]
* bundlebuilder
- Undocumented.
* Carbon [done: 2.6, 3.0]
* Carbon
- Carbon development has stopped.
- Does not support 64-bit systems completely.
- Dependent on bgen which has never been updated to support UCS-4
Unicode builds of Python.
* CodeWarrior [done: 2.6, 3.0]
* CodeWarrior
- Undocumented.
- Package under lib-scriptpackages.
* ColorPicker [done: 2.6, 3.0]
* ColorPicker
- Better to use Cocoa for GUIs.
* EasyDialogs [done: 2.6, 3.0]
* EasyDialogs
- Better to use Cocoa for GUIs.
* Explorer [done: 2.6, 3.0]
* Explorer
- Undocumented.
- Package under lib-scriptpackages.
* Finder [done: 2.6, 3.0]
* Finder
- Undocumented.
- Package under lib-scriptpackages.
* findertools [done: 2.6, 3.0]
* findertools
- No longer useful.
* FrameWork [done: 2.6, 3.0]
* FrameWork
- Poorly documented.
- Not updated to support Carbon Events.
* gensuitemodule [done: 2.6, 3.0]
* gensuitemodule
- See aepack.
* ic [done: 2.6, 3.0]
* ic
* icglue [done: 2.6, 3.0]
* icglue
* icopen [done: 2.6, 3.0]
* icopen
- Not needed on OS X.
- Meant to replace 'open' which is usually a bad thing to do.
* macerrors [done: 2.6, 3.0]
* macerrors
- Undocumented.
* MacOS [done: 2.6, 3.0]
* MacOS
- Would also mean the removal of binhex.
* macostools [done: 2.6, 3.0]
* macostools
* macresource [done: 2.6, 3.0]
* macresource
- Undocumented.
* MiniAEFrame [done: 2.6, 3.0]
* MiniAEFrame
- See aepack.
* Nav [done: 2.6, 3.0]
* Nav
- Undocumented.
* Netscape [done: 2.6, 3.0]
* Netscape
- Undocumented.
- Package under lib-scriptpackages.
* OSATerminology [done: 2.6, 3.0]
* OSATerminology
* pimp [done: 2.6, 3.0]
* pimp
- Undocumented.
* PixMapWrapper [done: 2.6, 3.0]
* PixMapWrapper
- Undocumented.
* StdSuites [done: 2.6, 3.0]
* StdSuites
- Undocumented.
- Package under lib-scriptpackages.
* SystemEvents [done: 2.6, 3.0]
* SystemEvents
- Undocumented.
- Package under lib-scriptpackages.
* Terminal [done: 2.6, 3.0]
* Terminal
- Undocumented.
- Package under lib-scriptpackages.
* terminalcommand [done: 2.6, 3.0]
* terminalcommand
- Undocumented.
* videoreader [done: 2.6, 3.0]
* videoreader
- No longer used.
* W [done: 2.6, 3.0]
* W
- No longer distributed with Python.
@ -438,33 +438,33 @@ A stub module for proxy access will be provided for use by urllib.
.. _PyObjC: http://pyobjc.sourceforge.net/
Solaris [done]
Solaris
///////////////
+ SUNAUDIODEV/sunaudiodev [done: 2.6, 3.0]
+ SUNAUDIODEV/sunaudiodev
- Access to the sound card on Sun machines.
- Code not uniquely edited in over eight years.
Hardly used
------------
Hardly used [done]
------------------
Some platform-independent modules are rarely used. There are a number of
possible explanations for this, including, ease of reimplementation, very
small audience or lack of adherence to more modern standards.
* audiodev [done: 2.6, 3.0]
* audiodev
+ Undocumented.
+ Not edited in five years.
* imputil [done: 2.6, 3.0]
* imputil
+ Undocumented.
+ Never updated to support absolute imports.
* mutex [done: 2.6, 3.0]
* mutex
+ Easy to implement using a semaphore and a queue.
+ Cannot block on a lock attempt.
@ -473,42 +473,42 @@ small audience or lack of adherence to more modern standards.
+ Not thread-safe.
* stringold [done: 2.6, 3.0]
* 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).
* sunaudio [done: 2.6, 3.0]
* sunaudio
+ Undocumented.
+ Not edited in over seven years.
+ The ``sunau`` module provides similar abilities.
* toaiff [done: 2.6, 3.0 (moved to Demo)]
* toaiff
+ Undocumented.
+ Requires ``sox`` library to be installed on the system.
* user [done: 2.6, 3.0]
* user
+ Easily handled by allowing the application specify its own
module name, check for existence, and import if found.
* new [done: 2.6, 3.0]
* new
+ 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 [done: 2.6, 3.0]
* pure
+ Written before Pure Atria was bought by Rational which was then
bought by IBM (in other words, very old).
* test.testall [done: 2.6, 3.0]
* test.testall
+ From the days before regrtest.
@ -520,13 +520,13 @@ Becoming obsolete signifies that either another module in the stdlib
or a widely distributed third-party library provides a better solution
for what the module is meant for.
* Bastion/rexec [done: 2.6, 3.0]
* Bastion/rexec [done]
+ Restricted execution / security.
+ Turned off in Python 2.3.
+ Modules deemed unsafe.
* bsddb185 [done: 2.6, 3.0]
* bsddb185 [done]
+ Superceded by bsddb3
+ Not built by default.
@ -534,87 +534,87 @@ for what the module is meant for.
directly in new code".
+ Available externally from PyPI_.
* Canvas [done: 2.6, 3.0]
* Canvas [done]
+ Marked as obsolete in a comment by Guido since 2000
(see http://bugs.python.org/issue210677).
+ Better to use the ``Tkinter.Canvas`` class.
* commands [done: 2.6, 3.0]
* commands [done]
+ subprocess module replaces it [#pep-0324]_.
+ Remove getstatus(), move rest to subprocess.
* compiler [done: 2.6, 3.0]
* compiler [done]
+ Having to maintain both the built-in compiler and the stdlib
package is redundant [#ast-removal]_.
+ The AST created by the compiler is available [#ast]_.
+ Mechanism to compile from an AST needs to be added.
* dircache [done: 2.6, 3.0]
* dircache [done]
+ Negligible use.
+ Easily replicated.
* dl [done: 2.6, 3.0]
* dl [done]
+ ctypes provides better support for same functionality.
* fpformat [done: 2.6, 3.0]
* fpformat [done]
+ All functionality is supported by string interpolation.
* htmllib [done: 2.6, 3.0]
* htmllib [done]
+ Superseded by HTMLParser.
* ihooks [done: 2.6, 3.0]
* ihooks [done]
+ Undocumented.
+ For use with rexec which has been turned off since Python 2.3.
* imageop [done: 2.6, 3.0]
* imageop [done]
+ Better support by third-party libraries
(Python Imaging Library [#pil]_).
+ Unit tests relied on rgbimg and imgfile.
- rgbimg was removed in Python 2.6.
- imgfile slated for removal in this PEP. [done: 3.0]
- imgfile slated for removal in this PEP.
* linuxaudiodev [done: 2.6, 3.0]
* linuxaudiodev [done]
+ Replaced by ossaudiodev.
* mhlib [done: 2.6, 3.0]
* mhlib [done]
+ Should be removed as an individual module; use ``mailbox``
instead.
* popen2 [done: 2.6, 3.0]
* popen2 [done]
+ subprocess module replaces it [#pep-0324]_.
* sgmllib [done: 2.6, 3.0]
* sgmllib [done]
+ Does not fully parse SGML.
+ In the stdlib for support to htmllib which is slated for removal.
* sre [done: 2.6, 3.0]
* sre [done]
+ Previously deprecated; import ``re`` instead.
* stat (TODO need to move all uses over to ``os.stat()``)
* stat [TODO need to move all uses over to ``os.stat()``]
+ ``os.stat()`` now returns a tuple with attributes.
+ Functions in the module should be made into methods for the object
returned by os.stat.
* statvfs [done: 2.6, 3.0]
* statvfs [done]
+ ``os.statvfs`` now returns a tuple with attributes.
* thread [done: 2.6, 3.0]
* thread [done]
+ People should use 'threading' instead.
@ -625,18 +625,18 @@ for what the module is meant for.
+ Guido has previously supported the deprecation
[#thread-deprecation]_.
* urllib [done: 2.6, 3.0]
* urllib [done]
+ Superceded by urllib2.
+ Functionality unique to urllib will be kept in the
urllib package.
* UserDict [done: 3.0] (TODO handle 2.6)
* UserDict [done: 3.0] [TODO handle 2.6]
+ Not as useful since types can be a superclass.
+ Useful bits moved to the 'collections' module.
* UserList/UserString [done: 2.6, 3.0]
* UserList/UserString [done]
+ Not useful since types can be a superclass.
+ Moved to the 'collections' module.
@ -680,11 +680,11 @@ by being moved to a package.
================== ==================================================
Current Name Replacement Name
================== ==================================================
_winreg winreg [done]
ConfigParser configparser [done]
copy_reg copyreg [done]
Queue queue [done]
SocketServer socketserver [done]
_winreg winreg
ConfigParser configparser
copy_reg copyreg
Queue queue
SocketServer socketserver
================== ==================================================
@ -709,17 +709,17 @@ is an externally maintained module and thus is not under the direct
control of the Python development team for renaming. See `Open
Issues`_ for a discussion on this.
* pickle/cPickle [done: cPickle gone and accelerated version added]
* pickle/cPickle [done]
+ Rename cPickle to _pickle.
+ Semantic completeness of C implementation *not* verified.
* profile/cProfile (TODO)
* profile/cProfile [TODO]
+ Rename cProfile to _profile.
+ Semantic completeness of C implementation *not* verified.
* StringIO/cStringIO [done: cStringIO gone and accelerated version added]
* StringIO/cStringIO [done]
+ Add the class to the 'io' module.
@ -735,7 +735,7 @@ should be renamed to reflect this fact.
============ ===============================
Current Name Replacement Name
============ ===============================
markupbase _markupbase [done]
markupbase _markupbase
============ ===============================
@ -749,20 +749,20 @@ beyond the 2.x series.
================= ===============================
Current Name Replacement Name
================= ===============================
repr reprlib [done]
test.test_support test.support [done]
repr reprlib
test.test_support test.support
================= ===============================
Grouping of modules
-------------------
Grouping of modules [done]
--------------------------
As the stdlib has grown, several areas within it have expanded to
include multiple modules (e.g., support for database files). It
thus makes sense to group related modules into packages.
dbm package [done]
dbm package
//////////////////
================= ===============================
@ -783,7 +783,7 @@ whichdb dbm.__init__ [1]_
html package [done]
html package
///////////////////
================== ===============================
@ -794,7 +794,7 @@ htmlentitydefs html.entities
================== ===============================
http package [done]
http package
///////////////////
================= ===============================
@ -812,7 +812,7 @@ cookielib http.cookiejar
safely as they have no naming conflicts.
tkinter package [done]
tkinter package
//////////////////////
================== ===============================
@ -843,7 +843,7 @@ turtle tkinter.turtle
and ``tkSimpleDialog`` have no naming conflicts.
urllib package [done: 3.0] (TODO urllib(2) fixers)
urllib package
//////////////////////////////////////////////////
Originally this new package was to be named ``url``, but because of
@ -866,7 +866,7 @@ robotparser urllib.robotparser
as long as the documentation for both modules is updated.
xmlrpc package [done]
xmlrpc package
/////////////////////
================== ===============================