[Python-checkins] cpython (3.3): More whatsnew updates.

[r.david.murray]

http://hg.python.org/cpython/rev/fa3dcc8c9e52
changeset:   79415:fa3dcc8c9e52
branch:      3.3
parent:      79413:4bf73d604537
user:        R David Murray <rdmurray at bitdance.com>
date:        Tue Oct 02 18:24:56 2012 -0400
summary:
  More whatsnew updates.

files:
  Doc/whatsnew/3.3.rst |  91 ++++++++++++++++++++++---------
  Misc/NEWS            |   2 +-
  2 files changed, 65 insertions(+), 28 deletions(-)


diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
--- a/Doc/whatsnew/3.3.rst
+++ b/Doc/whatsnew/3.3.rst
@@ -1328,7 +1328,24 @@
 Other API Changes
 ~~~~~~~~~~~~~~~~~
 
-Added :class:`email.parser.BytesHeaderParser`.
+New :class:`~email.parser.BytesHeaderParser`, added to the :mod:`~email.parser`
+module to complement :class:`~email.parser.HeaderParser` and complete the Bytes
+API.
+
+New utility functions:
+
+   * :func:`~email.utils.format_datetime`: given a :class:`~datetime.datetime`,
+     produce a string formatted for use in an email header.
+
+   * :func:`~email.utils.parsedate_to_datetime`: given a date string from
+     an email header, convert it into an aware :class:`~datetime.datetime`,
+     or a naive :class:`~datetime.datetime` if the offset is ``-0000``.
+
+   * :func:`~email.utils.localtime`: With no argument, returns the
+     current local time as an aware :class:`~datetime.datetime` using the local
+     :class:`~datetime.timezone`.  Given an aware :class:`~datetime.datetime`,
+     converts it into an aware :class:`~datetime.datetime` using the
+     local :class:`~datetime.timezone`.
 
 
 ftplib
@@ -1453,8 +1470,14 @@
 logging
 -------
 
-:func:`~logging.basicConfig` now supports an optional ``handlers`` argument
-taking an iterable of handlers to be added to the root logger.
+The :func:`~logging.basicConfig` function now supports an optional ``handlers``
+argument taking an iterable of handlers to be added to the root logger.
+
+A class level attribute :attr:`~logging.handlers.SysLogHandler.append_nul` has
+been added to :class:`~logging.handlers.SysLogHandler` to allow control of the
+appending of the ``NUL`` (``\000``) byte to syslog records, since for some
+deamons it is required while for others it is passed through to the log.
+
 
 
 math
@@ -1466,6 +1489,15 @@
 (Written by Mark Dickinson in :issue:`11888`).
 
 
+mmap
+----
+
+The :meth:`~mmap.mmap.read` method is now more compatible with other file-like
+objects: if the argument is omitted or specified as ``None``, it returns the
+bytes from the current file position to the end of the mapping.  (Contributed
+by Petri Lehtinen in :issue:`12021`.)
+
+
 multiprocessing
 ---------------
 
@@ -1752,34 +1784,28 @@
   instead of a RuntimeError: OSError has an errno attribute.
 
 
-smtp
-----
+smtpd
+-----
+
+The :mod:`smtpd` module now supports :rfc:`5321` (extended SMTP) and :rfc:`1870`
+(size extension).  Per the standard, these extensions are enabled if and only
+if the client initiates the session with an ``EHLO`` command.
+
+(Initial ``ELHO`` support by Alberto Trevino.  Size extension by Juhana
+Jauhiainen.  Substantial additional work on the patch contributed by Michele
+Orrù and Dan Boswell.  :issue:`8739`)
+
+
+smtplib
+-------
 
 :class:`~smtplib.SMTP` now supports the context manager protocol, allowing an
 ``SMTP`` instance to be used in a ``with`` statement.  (Contributed
 by Giampaolo Rodolà in :issue:`11289`.)
 
-
-smtpd
------
-
-The :mod:`smtpd` module now supports :rfc:`5321` (extended SMTP) and :rfc:`1870`
-(size extension).  Per the standard, these extensions are enabled if and only
-if the client initiates the session with an ``EHLO`` command.
-
-(Initial ``ELHO`` support by Alberto Trevino.  Size extension by Juhana
-Jauhiainen.  Substantial additional work on the patch contributed by Michele
-Orrù and Dan Boswell.  :issue:`8739`)
-
-
-smtplib
--------
-
 The :class:`~smtplib.SMTP_SSL` constructor and the :meth:`~smtplib.SMTP.starttls`
 method now accept an SSLContext parameter to control parameters of the secure
-channel.
-
-(Contributed by Kasun Herath in :issue:`8809`)
+channel.  (Contributed by Kasun Herath in :issue:`8809`)
 
 
 socket
@@ -1942,6 +1968,10 @@
   :func:`~time.clock_settime` functions with ``CLOCK_xxx`` constants.
   (Contributed by Victor Stinner in :issue:`10278`)
 
+To improve cross platform consistency, :func:`~time.sleep` now raises a
+:exc:`ValueError` when passed a negative sleep value.  Previously this was an
+error on posix, but produced an infinite sleep on Windows.
+
 
 types
 -----
@@ -2283,9 +2313,16 @@
 
 * The deprecated variable ``time.accept2dyear`` has been removed.
 
-* The undocumented internal helper class ``SSLFakeFile`` has been
-  removed from :mod:`smtplib`, since its functionality has long been
-  provided directly by :meth:`socket.socket.makefile`.
+* The undocumented internal helper class ``SSLFakeFile`` has been removed
+  from :mod:`smtplib`, since its functionality has long been provided directly
+  by :meth:`socket.socket.makefile`.
+
+* Passing a negative value to :func:`time.sleep` on Windows now raises an
+  error instead of sleeping forever.  It has always raised an error on posix.
+
+* The ``ast.__version__`` constant has been removed.  If you need to
+  make decisions affected by the AST version, use :attr:`sys.version_info`
+  to make the decision.
 
 
 Porting C code
diff --git a/Misc/NEWS b/Misc/NEWS
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -3147,7 +3147,7 @@
 - Issue #12352: Fix a deadlock in multiprocessing.Heap when a block is freed by
   the garbage collector while the Heap lock is held.
 
-- Issue #12462: time.sleep() now calls immediatly the (Python) signal handler
+- Issue #12462: time.sleep() now immediately calls the (Python) signal handler
   if it is interrupted by a signal, instead of having to wait until the next
   instruction.
 

-- 
Repository URL: http://hg.python.org/cpython