From 8f320ce8acf809dd54f9c1f1fb77b89f76e1c353 Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Fri, 7 Jul 2006 03:33:39 +0000 Subject: [PATCH] Reference cleanup and reformatting of modules to be removed. --- pep-3100.txt | 113 +++++++++++++++++++++++++-------------------------- 1 file changed, 55 insertions(+), 58 deletions(-) diff --git a/pep-3100.txt b/pep-3100.txt index ec657e8fa..98bddadac 100644 --- a/pep-3100.txt +++ b/pep-3100.txt @@ -63,7 +63,7 @@ Style changes 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 @@ Core language * 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 @@ To be removed: * ``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 @@ Built-in Namespace * 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 @@ Standard library 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 @@ References .. [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 @@ References 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 @@ References .. [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 @@ References .. [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 @@ References http://www.python.org/dev/peps/pep-3099 + Copyright =========