From b9706da528e5ab4113bf013ca8d9185962de4911 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Wed, 18 Nov 2009 18:54:21 +0000 Subject: [PATCH] Merged revisions 76366 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r76366 | georg.brandl | 2009-11-18 18:52:23 +0000 (Mi, 18 Nov 2009) | 1 line Make separate section for deprecations in 2.6 whatsnew. ........ --- Doc/whatsnew/2.6.rst | 133 +++++++++++++++++++++++-------------------- 1 file changed, 71 insertions(+), 62 deletions(-) diff --git a/Doc/whatsnew/2.6.rst b/Doc/whatsnew/2.6.rst index 8368f6a704d..ea67ba167b5 100644 --- a/Doc/whatsnew/2.6.rst +++ b/Doc/whatsnew/2.6.rst @@ -1629,11 +1629,6 @@ Some smaller changes made to the core Python language are: :cfunc:`PyObject_HashNotImplemented`. (Fixed by Nick Coghlan and Amaury Forgeot d'Arc; :issue:`2235`.) -* Changes to the :class:`Exception` interface - as dictated by :pep:`352` continue to be made. For 2.6, - the :attr:`message` attribute is being deprecated in favor of the - :attr:`args` attribute. - * The :exc:`GeneratorExit` exception now subclasses :exc:`BaseException` instead of :exc:`Exception`. This means that an exception handler that does ``except Exception:`` @@ -1770,8 +1765,8 @@ by Martin von Loewis.) .. ====================================================================== -New, Improved, and Deprecated Modules -===================================== +New and Improved Modules +======================== As in every release, Python's standard library received a number of enhancements and bug fixes. Here's a partial list of the most notable @@ -1779,36 +1774,6 @@ changes, sorted alphabetically by module name. Consult the :file:`Misc/NEWS` file in the source tree for a more complete list of changes, or look through the Subversion logs for all the details. -* (3.0-warning mode) Python 3.0 will feature a reorganized standard - library that will drop many outdated modules and rename others. - Python 2.6 running in 3.0-warning mode will warn about these modules - when they are imported. - - The list of deprecated modules is: - :mod:`audiodev`, - :mod:`bgenlocations`, - :mod:`buildtools`, - :mod:`bundlebuilder`, - :mod:`Canvas`, - :mod:`compiler`, - :mod:`dircache`, - :mod:`dl`, - :mod:`fpformat`, - :mod:`gensuitemodule`, - :mod:`ihooks`, - :mod:`imageop`, - :mod:`imgfile`, - :mod:`linuxaudiodev`, - :mod:`mhlib`, - :mod:`mimetools`, - :mod:`multifile`, - :mod:`new`, - :mod:`pure`, - :mod:`statvfs`, - :mod:`sunaudiodev`, - :mod:`test.testall`, and - :mod:`toaiff`. - * The :mod:`asyncore` and :mod:`asynchat` modules are being actively maintained again, and a number of patches and bugfixes were applied. (Maintained by Josiah Carlson; see :issue:`1736190` for @@ -1993,8 +1958,6 @@ changes, or look through the Subversion logs for all the details. a Unicode path was used and Unicode filenames are matched within the directory. (:issue:`1001604`) -* The :mod:`gopherlib` module has been removed. - * A new function in the :mod:`heapq` module, ``merge(iter1, iter2, ...)``, takes any number of iterables returning data in sorted order, and returns a new generator that returns the contents of all @@ -2154,13 +2117,6 @@ changes, or look through the Subversion logs for all the details. (Contributed by Christian Heimes and Mark Dickinson.) -* The :mod:`MimeWriter` module and :mod:`mimify` module - have been deprecated; use the :mod:`email` - package instead. - -* The :mod:`md5` module has been deprecated; use the :mod:`hashlib` module - instead. - * :class:`mmap` objects now have a :meth:`rfind` method that searches for a substring beginning at the end of the string and searching backwards. The :meth:`find` method also gained an *end* parameter @@ -2243,10 +2199,7 @@ changes, or look through the Subversion logs for all the details. and can optionally take new command-line arguments for the program. (Contributed by Rocky Bernstein; :issue:`1393667`.) -* The :mod:`posixfile` module has been deprecated; :func:`fcntl.lockf` - provides better locking. - - The :func:`post_mortem` function, used to begin debugging a +* The :func:`pdb.post_mortem` function, used to begin debugging a traceback, will now use the traceback returned by :func:`sys.exc_info` if no traceback is supplied. (Contributed by Facundo Batista; :issue:`1106316`.) @@ -2256,9 +2209,6 @@ changes, or look through the Subversion logs for all the details. opcodes, returning a shorter pickle that contains the same data structure. (Contributed by Raymond Hettinger.) -* The :mod:`popen2` module has been deprecated; use the :mod:`subprocess` - module. - * A :func:`get_data` function was added to the :mod:`pkgutil` module that returns the contents of resource files included with an installed Python package. For example:: @@ -2314,8 +2264,6 @@ changes, or look through the Subversion logs for all the details. (Contributed by Guido van Rossum from work for Google App Engine; :issue:`3487`.) -* The :mod:`rgbimg` module has been removed. - * The :mod:`rlcompleter` module's :meth:`Completer.complete()` method will now ignore exceptions triggered while evaluating a name. (Fixed by Lorenz Quack; :issue:`2250`.) @@ -2334,12 +2282,6 @@ changes, or look through the Subversion logs for all the details. for that file. (Contributed by Christian Heimes; :issue:`1657`.) -* The :mod:`sets` module has been deprecated; it's better to - use the built-in :class:`set` and :class:`frozenset` types. - -* The :mod:`sha` module has been deprecated; use the :mod:`hashlib` module - instead. - * The :func:`shutil.copytree` function now has an optional *ignore* argument that takes a callable object. This callable will receive each directory path and a list of the directory's contents, and returns a list of names that @@ -2402,7 +2344,7 @@ changes, or look through the Subversion logs for all the details. e-mail between agents that don't manage a mail queue. (LMTP implemented by Leif Hedstrom; :issue:`957003`.) - SMTP.starttls() now complies with :rfc:`3207` and forgets any + :meth:`SMTP.starttls` now complies with :rfc:`3207` and forgets any knowledge obtained from the server not obtained from the TLS negotiation itself. (Patch contributed by Bill Fenner; :issue:`829951`.) @@ -2951,6 +2893,73 @@ obtain certificate info by calling the :meth:`getpeercert` method. .. ====================================================================== +Deprecations and Removals +========================= + +* String exceptions have been removed. Attempting to use them raises a + :exc:`TypeError`. + +* Changes to the :class:`Exception` interface + as dictated by :pep:`352` continue to be made. For 2.6, + the :attr:`message` attribute is being deprecated in favor of the + :attr:`args` attribute. + +* (3.0-warning mode) Python 3.0 will feature a reorganized standard + library that will drop many outdated modules and rename others. + Python 2.6 running in 3.0-warning mode will warn about these modules + when they are imported. + + The list of deprecated modules is: + :mod:`audiodev`, + :mod:`bgenlocations`, + :mod:`buildtools`, + :mod:`bundlebuilder`, + :mod:`Canvas`, + :mod:`compiler`, + :mod:`dircache`, + :mod:`dl`, + :mod:`fpformat`, + :mod:`gensuitemodule`, + :mod:`ihooks`, + :mod:`imageop`, + :mod:`imgfile`, + :mod:`linuxaudiodev`, + :mod:`mhlib`, + :mod:`mimetools`, + :mod:`multifile`, + :mod:`new`, + :mod:`pure`, + :mod:`statvfs`, + :mod:`sunaudiodev`, + :mod:`test.testall`, and + :mod:`toaiff`. + +* The :mod:`gopherlib` module has been removed. + +* The :mod:`MimeWriter` module and :mod:`mimify` module + have been deprecated; use the :mod:`email` + package instead. + +* The :mod:`md5` module has been deprecated; use the :mod:`hashlib` module + instead. + +* The :mod:`posixfile` module has been deprecated; :func:`fcntl.lockf` + provides better locking. + +* The :mod:`popen2` module has been deprecated; use the :mod:`subprocess` + module. + +* The :mod:`rgbimg` module has been removed. + +* The :mod:`sets` module has been deprecated; it's better to + use the built-in :class:`set` and :class:`frozenset` types. + +* The :mod:`sha` module has been deprecated; use the :mod:`hashlib` module + instead. + + +.. ====================================================================== + Build and C API Changes =======================