[Python-checkins] Rebased version of what's new PR (#16745)

Sun Oct 13 11:51:40 EDT 2019

https://github.com/python/cpython/commit/bb78f6cfa6f2b84fa4611d39c35baf1c7dce7f8d
commit: bb78f6cfa6f2b84fa4611d39c35baf1c7dce7f8d
branch: master
author: Andrew Kuchling <amk at amk.ca>
committer: GitHub <noreply at github.com>
date: 2019年10月13日T11:51:36-04:00
summary:
Rebased version of what's new PR (#16745)
* Use Unicode character for accent
* Various grammar fixes
* Sort library modules alphabetically; remove duplicated idlelib/IDLE section
files:
M Doc/whatsnew/3.8.rst

diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index a609d19776e3d..422a6497e0a2e 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -82,7 +82,7 @@ Assignment expressions
 ----------------------
 
 There is new syntax ``:=`` that assigns values to variables as part of a larger
-expression. It is affectionately known as "walrus operator" due to
+expression. It is affectionately known as "the walrus operator" due to
 its resemblance to `the eyes and tusks of a walrus
 <https://en.wikipedia.org/wiki/Walrus#/media/File:Pacific_Walrus_-_Bull_(8247646168).jpg>`_.
 
@@ -620,6 +620,16 @@ where the DLL is stored (if a full or partial path is used to load the initial
 DLL) and paths added by :func:`~os.add_dll_directory`.
 
 
+datetime
+--------
+
+Added new alternate constructors :meth:`datetime.date.fromisocalendar` and
+:meth:`datetime.datetime.fromisocalendar`, which construct :class:`date` and
+:class:`datetime` objects respectively from ISO year, week number, and weekday;
+these are the inverse of each class's ``isocalendar`` method.
+(Contributed by Paul Ganssle in :issue:`36004`.)
+
+
 functools
 ---------
 
@@ -637,14 +647,12 @@ than as a function returning a decorator. So both of these are now supported::
 (Contributed by Raymond Hettinger in :issue:`36772`.)
 
 
-datetime
---------
+gc
+--
 
-Added new alternate constructors :meth:`datetime.date.fromisocalendar` and
-:meth:`datetime.datetime.fromisocalendar`, which construct :class:`date` and
-:class:`datetime` objects respectively from ISO year, week number and weekday;
-these are the inverse of each class's ``isocalendar`` method.
-(Contributed by Paul Ganssle in :issue:`36004`.)
+:func:`~gc.get_objects` can now receive an optional *generation* parameter
+indicating a generation to get objects from. Contributed in
+:issue:`36016` by Pablo Galindo.
 
 
 gettext
@@ -654,6 +662,18 @@ Added :func:`~gettext.pgettext` and its variants.
 (Contributed by Franz Glasner, Éric Araujo, and Cheryl Sabella in :issue:`2504`.)
 
 
+gzip
+----
+
+Added the *mtime* parameter to :func:`gzip.compress` for reproducible output.
+(Contributed by Guo Ci Teo in :issue:`34898`.)
+
+A :exc:`~gzip.BadGzipFile` exception is now raised instead of :exc:`OSError`
+for certain types of invalid or corrupt gzip files.
+(Contributed by Filip Gruszczyński, Michele Orrù, and Zackery Spytz in
+:issue:`6584`.)
+
+
 idlelib and IDLE
 ----------------
 
@@ -704,44 +724,6 @@ fails. The exception is ignored silently by default in release build.
 (Contributed by Victor Stinner in :issue:`18748`.)
 
 
-gc
---
-
-:func:`~gc.get_objects` can now receive an optional *generation* parameter
-indicating a generation to get objects from. Contributed in
-:issue:`36016` by Pablo Galindo.
-
-
-gzip
-----
-
-Added the *mtime* parameter to :func:`gzip.compress` for reproducible output.
-(Contributed by Guo Ci Teo in :issue:`34898`.)
-
-A :exc:`~gzip.BadGzipFile` exception is now raised instead of :exc:`OSError`
-for certain types of invalid or corrupt gzip files.
-(Contributed by Filip Gruszczyński, Michele Orrù, and Zackery Spytz in
-:issue:`6584`.)
-
-
-idlelib and IDLE
-----------------
-
-Add optional line numbers for IDLE editor windows. Windows
-open without line numbers unless set otherwise in the General
-tab of the configuration dialog.
-(Contributed by Tal Einat and Saimadhav Heblikar in :issue:`17535`.)
-
-Output over N lines (50 by default) is squeezed down to a button.
-N can be changed in the PyShell section of the General page of the
-Settings dialog. Fewer, but possibly extra long, lines can be squeezed by
-right clicking on the output. Squeezed output can be expanded in place
-by double-clicking the button or into the clipboard or a separate window
-by right-clicking the button. (Contributed by Tal Einat in :issue:`1529353`.)
-
-The changes above have been backported to 3.7 maintenance releases.
-
-
 json.tool
 ---------
 
@@ -899,18 +881,6 @@ py_compile
 (Contributed by Joannah Nanjekye in :issue:`22640`.)
 
 
-socket
-------
-
-Added :meth:`~socket.create_server()` and :meth:`~socket.has_dualstack_ipv6()`
-convenience functions to automate the necessary tasks usually involved when
-creating a server socket, including accepting both IPv4 and IPv6 connections
-on the same socket. (Contributed by Giampaolo Rodola in :issue:`17561`.)
-
-The :func:`socket.if_nameindex()`, :func:`socket.if_nametoindex()`, and
-:func:`socket.if_indextoname()` functions have been implemented on Windows.
-(Contributed by Zackery Spytz in :issue:`37007`.)
-
 shlex
 ----------
 
@@ -932,6 +902,19 @@ inherited from the corresponding change to the :mod:`tarfile` module.
 recursively removing their contents first.
 
 
+socket
+------
+
+Added :meth:`~socket.create_server()` and :meth:`~socket.has_dualstack_ipv6()`
+convenience functions to automate the necessary tasks usually involved when
+creating a server socket, including accepting both IPv4 and IPv6 connections
+on the same socket. (Contributed by Giampaolo Rodolà in :issue:`17561`.)
+
+The :func:`socket.if_nameindex()`, :func:`socket.if_nametoindex()`, and
+:func:`socket.if_indextoname()` functions have been implemented on Windows.
+(Contributed by Zackery Spytz in :issue:`37007`.)
+
+
 ssl
 ---
 
@@ -1202,14 +1185,14 @@ Optimizations
 +26% on Linux, +50% on macOS and +40% on Windows. Also, much less CPU cycles
 are consumed.
 See :ref:`shutil-platform-dependent-efficient-copy-operations` section.
- (Contributed by Giampaolo Rodola' in :issue:`33671`.)
+ (Contributed by Giampaolo Rodolà in :issue:`33671`.)
 
 * :func:`shutil.copytree` uses :func:`os.scandir` function and all copy
 functions depending from it use cached :func:`os.stat` values. The speedup
 for copying a directory with 8000 files is around +9% on Linux, +20% on
 Windows and +30% on a Windows SMB share. Also the number of :func:`os.stat`
 syscalls is reduced by 38% making :func:`shutil.copytree` especially faster
- on network filesystems. (Contributed by Giampaolo Rodola' in :issue:`33695`.)
+ on network filesystems. (Contributed by Giampaolo Rodolà in :issue:`33695`.)
 
 * The default protocol in the :mod:`pickle` module is now Protocol 4,
 first introduced in Python 3.4. It offers better performance and smaller
@@ -1361,7 +1344,7 @@ Deprecated
 (Contributed by Victor Stinner in :issue:`37481`.)
 
 * Deprecated methods ``getchildren()`` and ``getiterator()`` in
- the :mod:`~xml.etree.ElementTree` module emit now a
+ the :mod:`~xml.etree.ElementTree` module now emit a
 :exc:`DeprecationWarning` instead of :exc:`PendingDeprecationWarning`.
 They will be removed in Python 3.9.
 (Contributed by Serhiy Storchaka in :issue:`29209`.)
@@ -1454,28 +1437,29 @@ The following features and APIs have been removed from Python 3.8:
 * The :mod:`macpath` module, deprecated in Python 3.7, has been removed.
 (Contributed by Victor Stinner in :issue:`35471`.)
 
-* The function :func:`platform.popen` has been removed, it was deprecated since
- Python 3.3: use :func:`os.popen` instead.
+* The function :func:`platform.popen` has been removed, after having been
+ deprecated since Python 3.3: use :func:`os.popen` instead.
 (Contributed by Victor Stinner in :issue:`35345`.)
 
-* The function :func:`time.clock` has been removed, it was deprecated since Python
- 3.3: use :func:`time.perf_counter` or :func:`time.process_time` instead, depending
- on your requirements, to have a well defined behavior.
+* The function :func:`time.clock` has been removed, after having been
+ deprecated since Python 3.3: use :func:`time.perf_counter` or
+ :func:`time.process_time` instead, depending
+ on your requirements, to have well-defined behavior.
 (Contributed by Matthias Bussonnier in :issue:`36895`.)
 
 * The ``pyvenv`` script has been removed in favor of ``python3.8 -m venv``
 to help eliminate confusion as to what Python interpreter the ``pyvenv``
 script is tied to. (Contributed by Brett Cannon in :issue:`25427`.)
 
-* ``parse_qs``, ``parse_qsl``, and ``escape`` are removed from :mod:`cgi`
- module. They are deprecated from Python 3.2 or older. They should be imported
+* ``parse_qs``, ``parse_qsl``, and ``escape`` are removed from the :mod:`cgi`
+ module. They are deprecated in Python 3.2 or older. They should be imported
 from the ``urllib.parse`` and ``html`` modules instead.
 
-* ``filemode`` function is removed from :mod:`tarfile` module.
+* ``filemode`` function is removed from the :mod:`tarfile` module.
 It is not documented and deprecated since Python 3.3.
 
 * The :class:`~xml.etree.ElementTree.XMLParser` constructor no longer accepts
- the *html* argument. It never had effect and was deprecated in Python 3.4.
+ the *html* argument. It never had an effect and was deprecated in Python 3.4.
 All other parameters are now :ref:`keyword-only <keyword-only_parameter>`.
 (Contributed by Serhiy Storchaka in :issue:`29209`.)
 
@@ -1534,8 +1518,8 @@ Changes in Python behavior
 
 * On AIX, :attr:`sys.platform` doesn't contain the major version anymore.
 It is always ``'aix'``, instead of ``'aix3'`` .. ``'aix7'``. Since
- older Python versions include the version number, it is recommended to
- always use the ``sys.platform.startswith('aix')``.
+ older Python versions include the version number, so it is recommended to
+ always use ``sys.platform.startswith('aix')``.
 (Contributed by M. Felt in :issue:`36588`.)
 
 * :c:func:`PyEval_AcquireLock` and :c:func:`PyEval_AcquireThread` now
@@ -1555,8 +1539,8 @@ Changes in the Python API
 
 * :class:`subprocess.Popen` can now use :func:`os.posix_spawn` in some cases
 for better performance. On Windows Subsystem for Linux and QEMU User
- Emulation, Popen constructor using :func:`os.posix_spawn` no longer raise an
- exception on errors like missing program, but the child process fails with a
+ Emulation, the :class:`Popen` constructor using :func:`os.posix_spawn` no longer raises an
+ exception on errors like "missing program". Instead the child process fails with a
 non-zero :attr:`~Popen.returncode`.
 (Contributed by Joannah Nanjekye and Victor Stinner in :issue:`35537`.)
 
@@ -1569,7 +1553,7 @@ Changes in the Python API
 * The :meth:`imap.IMAP4.logout` method no longer ignores silently arbitrary
 exceptions.
 
-* The function :func:`platform.popen` has been removed, it was deprecated since
+* The function :func:`platform.popen` has been removed, after having been deprecated since
 Python 3.3: use :func:`os.popen` instead.
 (Contributed by Victor Stinner in :issue:`35345`.)
 
@@ -1584,9 +1568,9 @@ Changes in the Python API
 specialized methods like :meth:`~tkinter.ttk.Treeview.selection_set` for
 changing the selection. (Contributed by Serhiy Storchaka in :issue:`31508`.)
 
-* The :meth:`writexml`, :meth:`toxml` and :meth:`toprettyxml` methods of the
- :mod:`xml.dom.minidom` module, and :mod:`xml.etree` now preserve the attribute
- order specified by the user.
+* The :meth:`writexml`, :meth:`toxml` and :meth:`toprettyxml` methods of
+ :mod:`xml.dom.minidom`, and the :meth:`write` method of :mod:`xml.etree`,
+ now preserve the attribute order specified by the user.
 (Contributed by Diego Rojas and Raymond Hettinger in :issue:`34160`.)
 
 * A :mod:`dbm.dumb` database opened with flags ``'r'`` is now read-only.
@@ -1596,7 +1580,7 @@ Changes in the Python API
 
 * The ``doctype()`` method defined in a subclass of
 :class:`~xml.etree.ElementTree.XMLParser` will no longer be called and will
- cause emitting a :exc:`RuntimeWarning` instead of a :exc:`DeprecationWarning`.
+ emit a :exc:`RuntimeWarning` instead of a :exc:`DeprecationWarning`.
 Define the :meth:`doctype() <xml.etree.ElementTree.TreeBuilder.doctype>`
 method on a target for handling an XML doctype declaration.
 (Contributed by Serhiy Storchaka in :issue:`29209`.)
@@ -1639,7 +1623,7 @@ Changes in the Python API
 
 * The :meth:`mmap.flush() <mmap.mmap.flush>` method now returns ``None`` on
 success and raises an exception on error under all platforms. Previously,
- its behavior was platform-depended: a nonzero value was returned on success;
+ its behavior was platform-dependent: a nonzero value was returned on success;
 zero was returned on error under Windows. A zero value was returned on
 success; an exception was raised on error under Unix.
 (Contributed by Berker Peksag in :issue:`2122`.)
@@ -1683,7 +1667,7 @@ Changes in the Python API
 * :class:`types.CodeType` has a new parameter in the second position of the
 constructor (*posonlyargcount*) to support positional-only arguments defined
 in :pep:`570`. The first argument (*argcount*) now represents the total
- number of positional arguments (including positional-only arguments). A new
+ number of positional arguments (including positional-only arguments). The new
 ``replace()`` method of :class:`types.CodeType` can be used to make the code
 future-proof.
 
@@ -1691,9 +1675,9 @@ Changes in the Python API
 Changes in the C API
 --------------------
 
-* The :c:type:`PyCompilerFlags` structure gets a new *cf_feature_version*
+* The :c:type:`PyCompilerFlags` structure got a new *cf_feature_version*
 field. It should be initialized to ``PY_MINOR_VERSION``. The field is ignored
- by default, it is used if and only if ``PyCF_ONLY_AST`` flag is set in
+ by default, and is used if and only if ``PyCF_ONLY_AST`` flag is set in
 *cf_flags*.
 
 * The :c:func:`PyEval_ReInitThreads` function has been removed from the C API.
