[Python-checkins] r47286 - peps/trunk/pep-3100.txt
brett.cannon
python-checkins at python.org
Fri Jul 7 05:33:40 CEST 2006
Author: brett.cannon
Date: Fri Jul 7 05:33:39 2006
New Revision: 47286
Modified:
peps/trunk/pep-3100.txt
Log:
Reference cleanup and reformatting of modules to be removed.
Modified: peps/trunk/pep-3100.txt
==============================================================================
--- peps/trunk/pep-3100.txt (original)
+++ peps/trunk/pep-3100.txt Fri Jul 7 05:33:39 2006
@@ -63,7 +63,7 @@
Core language
=============
-* True division becomes default behavior [10]_
+* True division becomes default behavior [#pep238]_
* ``exec`` as a statement is not worth it -- make it a function
* Add optional declarations for static typing [11]_
* Support only new-style classes; classic classes will be gone [1]_
@@ -84,7 +84,7 @@
* floats will not be acceptable as arguments in place of ints for operations
where floats are inadvertantly accepted (PyArg_ParseTuple() i & l formats)
* Imports will be absolute by default.
- Relative imports must be explicitly specified [19]_
+ Relative imports must be explicitly specified [#pep328]_
* __init__.py will be optional in sub-packages. __init__.py will still
be required for top-level packages.
* Cleanup the Py_InitModule() variants {,3,4} (also import and parser APIs)
@@ -148,7 +148,7 @@
* ``basestring.find()`` and ``basestring.rfind()``; use ``basestring.index()``
or ``basestring.rindex()`` in a try/except block [15]_
-* ``file.xreadlines()`` method [17]_
+* ``file.xreadlines()`` method [#file-object]_
* ``dict.setdefault()`` [22]_
* ``dict.has_key()`` method
@@ -163,7 +163,7 @@
* Introduce ``trunc()``, which would call the ``__trunc__()`` method on its
argument; suggested use is for objects like float where calling ``__int__()``
has data loss, but an integral representation is still desired [8]_
-* Exception hierarchy changes [20]_
+* Exception hierarchy changes [#pep352]_
To be removed:
@@ -191,29 +191,26 @@
To be removed:
-* Deprecated modules, methods, parameters, attributes, etc. [1]_ [17]_ [18]_
- There may be other modules, the most common are listed below.
-
- stdlib modules to be removed (see docstrings and comments in the source):
- * ``macfs``, ``new``, ``reconvert``, ``stringold``, ``xmllib``
- * ``pcre``, ``pypcre``, ``strop``
- stdlib modules to be removed (see PEP 4): [18]_
- * ``posixfile``, ``pre``, ``regsub``, ``rfc822``,
- * ``statcache``, ``string``, ``TERMIOS``
- * ``mimetools``, ``MimeWriter``, ``mimify``,
- * ``mpz``, ``rgbimage``
- * Everything in lib-old: [18]_
- * Para.py, addpack.py, cmp.py, cmpcache.py, codehack.py,
- * dircmp.py, dump.py, find.py, fmt.py, grep.py, lockfile.py,
- * newdir.py, ni.py, packmail.py, poly.py, rand.py, statcache.py,
- * tb.py, tzparse.py, util.py, whatsound.py, whrandom.py, zmod.py
-
-* ``sys.exitfunc``: use atexit module instead [17]_
+* stdlib modules to be removed
+ + see docstrings and comments in the source
+ - ``macfs``, ``new``, ``reconvert``, ``stringold``, ``xmllib``,
+ ``pcre``, ``pypcre``, ``strop``
+ + see PEP 4 [18]_
+ - ``posixfile``, ``pre``, ``regsub``, ``rfc822``,
+ ``statcache``, ``string``, ``TERMIOS`` ``mimetools``,
+ ``MimeWriter``, ``mimify``, ``mpz``, ``rgbimage``
+ + Everything in lib-old [18]_
+ - ``Para``, ``addpack``, ``cmp``, ``cmpcache``, ``codehack``,
+ ``dircmp``, ``dump``, ``find``, ``fmt``, ``grep``,
+ ``lockfile``, ``newdir``, ``ni``, ``packmail``, ``poly``,
+ ``rand``, ``statcache``, ``tb``, ``tzparse``, ``util``,
+ ``whatsound``, ``whrandom``, ``zmod``
+* ``sys.exitfunc``: use atexit module instead [#sys-module]_
* ``sys.exc_type``, ``sys.exc_values``, ``sys.exc_traceback``:
not thread-safe; use ``sys.exc_info()`` or an attribute
- of the exception [2]_ [13]_ [17]_
-* ``array.read``, ``array.write`` [17]_
-* ``operator.isCallable``, ``operator.sequenceIncludes`` [17]_
+ of the exception [2]_ [13]_ [#sys-module]_
+* ``array.read``, ``array.write`` [#array-module]_
+* ``operator.isCallable``, ``operator.sequenceIncludes`` [#operator-module]_
* In the thread module, the aquire_lock() and release_lock() aliases
for the acquire() and release() methods on lock objects.
(Probably also just remove the thread module as a public API,
@@ -239,6 +236,12 @@
.. [2] Python Regrets:
http://www.python.org/doc/essays/ppt/regrets/PythonRegrets.pdf
+.. [9] Guido's blog ("The fate of reduce() in Python 3000")
+ http://www.artima.com/weblogs/viewpost.jsp?thread=98196
+
+.. [11] Guido's blog ("Python Optional Typechecking Redux")
+ http://www.artima.com/weblogs/viewpost.jsp?thread=89161
+
.. [3] Python Wiki:
http://www.python.org/moin/Python3.0
@@ -258,18 +261,6 @@
objects can be used")
http://mail.python.org/pipermail/python-dev/2005-February/051674.html
-.. [9] Guido's blog ("The fate of reduce() in Python 3000")
- http://www.artima.com/weblogs/viewpost.jsp?thread=98196
-
-.. [10] PEP 238 ("Changing the Division Operator")
- http://www.python.org/dev/peps/pep-0238
-
-.. [11] Guido's blog ("Python Optional Typechecking Redux")
- http://www.artima.com/weblogs/viewpost.jsp?thread=89161
-
-.. [12] PEP 289 ("Generator Expressions")
- http://www.python.org/dev/peps/pep-0289
-
.. [13] python-dev email ("anonymous blocks")
http://mail.python.org/pipermail/python-dev/2005-April/053060.html
@@ -282,31 +273,12 @@
.. [16] python-dev email (Replacement for print in Python 3.0)
http://mail.python.org/pipermail/python-dev/2005-September/056154.html
-.. [17] Python docs
- http://docs.python.org/ref/sequence-methods.html
- http://docs.python.org/lib/module-sys.html
- http://docs.python.org/lib/module-operator.html
- http://docs.python.org/lib/module-array.html
- http://docs.python.org/lib/bltin-file-objects.html
-
-.. [18] PEP 4 ("Deprecation of Standard Modules")
- http://www.python.org/dev/peps/pep-0004
-
-.. [19] PEP 328 ("Imports: Multi-Line and Absolute/Relative")
- http://www.python.org/dev/peps/pep-0328
-
-.. [20] PEP 352 ("Required Superclass for Exceptions")
- http://www.python.org/dev/peps/pep-0352
-
.. [21] python-dev email
http://mail.python.org/pipermail/python-dev/2006-February/061169.html
.. [22] python-dev email ("defaultdict")
http://mail.python.org/pipermail/python-dev/2006-February/061261.html
-.. [23] PEP 308 ("Conditional Expressions")
- http://www.python.org/dev/peps/pep-0308
-
.. [24] python-3000 email
http://mail.python.org/pipermail/python-3000/2006-April/000996.html
@@ -325,12 +297,36 @@
.. [29] python-3000 email ("bug in modulus?")
http://mail.python.org/pipermail/python-3000/2006-May/001735.html
-.. [30] PEP 299 ("Special __main__() function in modules")
- http://www.python.org/dev/peps/pep-0299
+.. [17] Python docs (Additional methods for emulation of sequence types)
+ http://docs.python.org/ref/sequence-methods.html
+
+.. [#sys-module] Python docs (sys -- System-specific parameters and functions)
+ http://docs.python.org/lib/module-sys.html
+
+.. [#operator-module] Python docs (operator -- Standard operators as functions)
+ http://docs.python.org/lib/module-operator.html
+
+.. [#array-module] Python docs (array -- Efficient arrays of numeric values)
+ http://docs.python.org/lib/module-array.html
+
+.. [#file-object] Python docs (File objects)
+ http://docs.python.org/lib/bltin-file-objects.html
+
+.. [18] PEP 4 ("Deprecation of Standard Modules")
+ http://www.python.org/dev/peps/pep-0004
.. [#pep238] PEP 238 (Changing the Division Operator)
http://www.python.org/dev/peps/pep-0238
+.. [12] PEP 289 ("Generator Expressions")
+ http://www.python.org/dev/peps/pep-0289
+
+.. [30] PEP 299 ("Special __main__() function in modules")
+ http://www.python.org/dev/peps/pep-0299
+
+.. [23] PEP 308 ("Conditional Expressions")
+ http://www.python.org/dev/peps/pep-0308
+
.. [#pep328] PEP 328 (Imports: Multi-Line and Absolute/Relative)
http://www.python.org/dev/peps/pep-0328
@@ -347,6 +343,7 @@
http://www.python.org/dev/peps/pep-3099
+
Copyright
=========
More information about the Python-checkins
mailing list