[Python-checkins] cpython: whatsnew: rewrite urllib, doctest, and poplib sections.

r.david.murray python-checkins at python.org
Fri Dec 27 23:02:09 CET 2013


http://hg.python.org/cpython/rev/d766589ed5a2
changeset:   88209:d766589ed5a2
user:        R David Murray <rdmurray at bitdance.com>
date:        Fri Dec 27 17:01:16 2013 -0500
summary:
  whatsnew: rewrite urllib, doctest, and poplib sections.

Also collapse redundant versionadded/versionchanged markup in
poplib.stls entry.

files:
  Doc/library/poplib.rst |  10 +++-----
  Doc/whatsnew/3.4.rst   |  33 ++++++++++++++---------------
  2 files changed, 20 insertions(+), 23 deletions(-)


diff --git a/Doc/library/poplib.rst b/Doc/library/poplib.rst
--- a/Doc/library/poplib.rst
+++ b/Doc/library/poplib.rst
@@ -198,15 +198,13 @@
 
    *context* parameter is a :class:`ssl.SSLContext` object which allows
    bundling SSL configuration options, certificates and private keys into
-   a single (potentially long-lived) structure.
+   a single (potentially long-lived) structure.  This method supports
+   hostname checking via :attr:`SSLContext.check_hostname`
+   :attr:`SSLContext.check_hostname` and *Server Name Indicator* (see
+   :data:`~ssl.HAS_SNI`).
 
    .. versionadded:: 3.4
 
-   .. versionchanged:: 3.4
-      The method now supports hostname check with
-      :attr:`SSLContext.check_hostname` and *Server Name Indicator* (see
-      :data:`~ssl.HAS_SNI`).
-
 
 Instances of :class:`POP3_SSL` have no additional methods. The interface of this
 subclass is identical to its parent.
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -554,15 +554,15 @@
 doctest
 -------
 
-Added :data:`~doctest.FAIL_FAST` flag to halt test running as soon as the first
-failure is detected.  (Contributed by R. David Murray and Daniel Urban in
-:issue:`16522`.)
+A new :ref:`option flag <doctest-options>`, :data:`~doctest.FAIL_FAST`, halts
+test running as soon as the first failure is detected.  (Contributed by R.
+David Murray and Daniel Urban in :issue:`16522`.)
 
-Updated the doctest command line interface to use :mod:`argparse`, and added
-``-o`` and ``-f`` options to the interface.  ``-o`` allows doctest options to
-be specified on the command line, and ``-f`` is a shorthand for ``-o
-FAIL_FAST`` (to parallel the similar option supported by the :mod:`unittest`
-CLI).  (Contributed by R. David Murray in :issue:`11390`.)
+The :mod:`doctest` command line interface now uses :mod:`argparse`, and has two
+new options, ``-o`` and ``-f``.  ``-o`` allows :ref:`doctest options
+<doctest-options>` to be specified on the command line, and ``-f`` is a
+shorthand for ``-o FAIL_FAST`` (to parallel the similar option supported by the
+:mod:`unittest` CLI).  (Contributed by R. David Murray in :issue:`11390`.)
 
 
 email
@@ -795,13 +795,11 @@
 poplib
 ------
 
-New :meth:`~poplib.POP3.stls` method to switch a clear-text POP3 session into
-an encrypted POP3 session.
-
-New :meth:`~poplib.POP3.capa` method to query the capabilities advertised by the
-POP3 server.
-
-(Contributed by Lorenzo Catucci in :issue:`4473`.)
+Two new methods have been added to :mod:`poplib`: :meth:`~poplib.POP3.capa`,
+which returns the list of capabilities advertised by the POP server, and
+:meth:`~poplib.POP3.stls`, which switches a clear-text POP3 session into an
+encrypted POP3 session if the POP server supports it.  (Contributed by Lorenzo
+Catucci in :issue:`4473`.)
 
 
 pprint
@@ -947,8 +945,9 @@
 urllib
 ------
 
-Add support.for ``data:`` URLs in :mod:`urllib.request`.
-(Contributed by Mathias Panzenböck in :issue:`16423`.)
+:mod:`urllib.request` now supports ``data:`` URLs via the
+:class:`~urllib.request.DataHandler` class.  (Contributed by Mathias Panzenböck
+in :issue:`16423`.)
 
 
 unittest

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


More information about the Python-checkins mailing list