[Python-checkins] r65784 - peps/trunk/pep-3108.txt
brett.cannon
python-checkins at python.org
Sun Aug 17 22:51:56 CEST 2008
Author: brett.cannon
Date: Sun Aug 17 22:51:56 2008
New Revision: 65784
Log:
Clean up listing of what has been done for PEP 3108 to make it easier to find what has not been done.
Modified:
peps/trunk/pep-3108.txt
Modified: peps/trunk/pep-3108.txt
==============================================================================
--- peps/trunk/pep-3108.txt (original)
+++ peps/trunk/pep-3108.txt Sun Aug 17 22:51:56 2008
@@ -64,55 +64,55 @@
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 @@
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 @@
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 @@
- 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 @@
.. _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 @@
+ 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 @@
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 @@
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 @@
+ 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 @@
================== ==================================================
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 @@
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 @@
============ ===============================
Current Name Replacement Name
============ ===============================
-markupbase _markupbase [done]
+markupbase _markupbase
============ ===============================
@@ -749,20 +749,20 @@
================= ===============================
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 @@
-html package [done]
+html package
///////////////////
================== ===============================
@@ -794,7 +794,7 @@
================== ===============================
-http package [done]
+http package
///////////////////
================= ===============================
@@ -812,7 +812,7 @@
safely as they have no naming conflicts.
-tkinter package [done]
+tkinter package
//////////////////////
================== ===============================
@@ -843,7 +843,7 @@
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 @@
as long as the documentation for both modules is updated.
-xmlrpc package [done]
+xmlrpc package
/////////////////////
================== ===============================
More information about the Python-checkins
mailing list