]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.12] GH-109190: Copyedit 3.12 What's New: Use the present tense (GH-109754) (#109827)
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Tue, 26 Sep 2023 00:36:31 +0000 (17:36 -0700)
committerGitHub <noreply@github.com>
Tue, 26 Sep 2023 00:36:31 +0000 (02:36 +0200)
GH-109190: Copyedit 3.12 What's New: Use the present tense (GH-109754)
(cherry picked from commit 4e478534d73e46aea5d10fb4e0ddf2c34440d0f6)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Doc/whatsnew/3.12.rst

index 4d8cf9fc8fe74faae19780f944072174fde84020..a14a231ec7e9030f1d8d27b84e38eaa34306f63e 100644 (file)
@@ -570,7 +570,7 @@ asyncio
   writing to sockets and uses :meth:`~socket.socket.sendmsg` if the platform
   supports it. (Contributed by Kumar Aditya in :gh:`91166`.)
 
-* Added :func:`asyncio.eager_task_factory` and :func:`asyncio.create_eager_task_factory`
+* Add :func:`asyncio.eager_task_factory` and :func:`asyncio.create_eager_task_factory`
   functions to allow opting an event loop in to eager task execution,
   making some use-cases 2x to 5x faster.
   (Contributed by Jacob Bower & Itamar Oren in :gh:`102853`, :gh:`104140`, and :gh:`104138`)
@@ -666,17 +666,17 @@ inspect
 itertools
 ---------
 
-* Added :class:`itertools.batched()` for collecting into even-sized
+* Add :class:`itertools.batched()` for collecting into even-sized
   tuples where the last batch may be shorter than the rest.
   (Contributed by Raymond Hettinger in :gh:`98363`.)
 
 math
 ----
 
-* Added :func:`math.sumprod` for computing a sum of products.
+* Add :func:`math.sumprod` for computing a sum of products.
   (Contributed by Raymond Hettinger in :gh:`100485`.)
 
-* Extended :func:`math.nextafter` to include a *steps* argument
+* Extend :func:`math.nextafter` to include a *steps* argument
   for moving up or down multiple steps at a time.
   (By Matthias Goergens, Mark Dickinson, and Raymond Hettinger in :gh:`94906`.)
 
@@ -749,10 +749,10 @@ pdb
 random
 ------
 
-* Added :func:`random.binomialvariate`.
+* Add :func:`random.binomialvariate`.
   (Contributed by Raymond Hettinger in :gh:`81620`.)
 
-* Added a default of ``lamb=1.0`` to :func:`random.expovariate`.
+* Add a default of ``lamb=1.0`` to :func:`random.expovariate`.
   (Contributed by Raymond Hettinger in :gh:`100234`.)
 
 shutil
@@ -811,7 +811,7 @@ sqlite3
 statistics
 ----------
 
-* Extended :func:`statistics.correlation` to include as a ``ranked`` method
+* Extend :func:`statistics.correlation` to include as a ``ranked`` method
   for computing the Spearman correlation of ranked data.
   (Contributed by Raymond Hettinger in :gh:`95861`.)
 
@@ -949,7 +949,7 @@ unicodedata
 unittest
 --------
 
-Added ``--durations`` command line option, showing the N slowest test cases::
+Add a ``--durations`` command line option, showing the N slowest test cases::
 
   python3 -m unittest --durations=3 lib.tests.test_threading
   .....
@@ -977,11 +977,11 @@ uuid
 Optimizations
 =============
 
-* Removed ``wstr`` and ``wstr_length`` members from Unicode objects.
+* Remove ``wstr`` and ``wstr_length`` members from Unicode objects.
   It reduces object size by 8 or 16 bytes on 64bit platform. (:pep:`623`)
   (Contributed by Inada Naoki in :gh:`92536`.)
 
-* Added experimental support for using the BOLT binary optimizer in the build
+* Add experimental support for using the BOLT binary optimizer in the build
   process, which improves performance by 1-5%.
   (Contributed by Kevin Modzelewski in :gh:`90536` and tuned by Donghee Na in :gh:`101525`)
 
@@ -1014,7 +1014,7 @@ CPython bytecode changes
 * Remove the :opcode:`!JUMP_IF_FALSE_OR_POP` and :opcode:`!JUMP_IF_TRUE_OR_POP`
   instructions. (Contributed by Irit Katriel in :gh:`102859`.)
 
-* Removed the :opcode:`!PRECALL` instruction. (Contributed by Mark Shannon in
+* Remove the :opcode:`!PRECALL` instruction. (Contributed by Mark Shannon in
   :gh:`92925`.)
 
 * Add the :opcode:`LOAD_FAST_AND_CLEAR` instruction as part of the
@@ -1440,9 +1440,9 @@ imp
             loader.exec_module(module)
             return module
 
-* Removed :mod:`!imp` functions and attributes with no replacements:
+* Remove :mod:`!imp` functions and attributes with no replacements:
 
-  * undocumented functions:
+  * Undocumented functions:
 
     * ``imp.init_builtin()``
     * ``imp.load_compiled()``
@@ -1523,7 +1523,7 @@ ssl
 unittest
 --------
 
-* Removed many old deprecated :mod:`unittest` features:
+* Remove many long-deprecated :mod:`unittest` features:
 
   * A number of :class:`~unittest.TestCase` method aliases:
 
@@ -1566,7 +1566,7 @@ webbrowser
 ----------
 
 * Remove support for obsolete browsers from :mod:`webbrowser`.
-  Removed browsers include: Grail, Mosaic, Netscape, Galeon, Skipstone,
+  The removed browsers include: Grail, Mosaic, Netscape, Galeon, Skipstone,
   Iceape, Firebird, and Firefox versions 35 and below (:gh:`102871`).
 
 xml.etree.ElementTree
@@ -1589,8 +1589,8 @@ zipimport
 Others
 ------
 
-* Removed the ``suspicious`` rule from the documentation :file:`Makefile`, and
-  removed ``Doc/tools/rstlint.py``, both in favor of `sphinx-lint
+* Remove the ``suspicious`` rule from the documentation :file:`Makefile` and
+  :file:`Doc/tools/rstlint.py`, both in favor of `sphinx-lint
   <https://github.com/sphinx-contrib/sphinx-lint>`_.
   (Contributed by Julien Palard in :gh:`98179`.)
 
@@ -1620,7 +1620,7 @@ Changes in the Python API
   contain ASCII letters and digits and underscore.
   (Contributed by Serhiy Storchaka in :gh:`91760`.)
 
-* Removed ``randrange()`` functionality deprecated since Python 3.10.  Formerly,
+* Remove ``randrange()`` functionality deprecated since Python 3.10.  Formerly,
   ``randrange(10.0)`` losslessly converted to ``randrange(10)``. Now, it raises a
   :exc:`TypeError`. Also, the exception raised for non-integer values such as
   ``randrange(10.5)`` or ``randrange('10')`` has been changed from :exc:`ValueError` to
@@ -1634,7 +1634,7 @@ Changes in the Python API
   to :term:`filesystem encoding and error handler`.
   Argument files should be encoded in UTF-8 instead of ANSI Codepage on Windows.
 
-* Removed the ``asyncore``-based ``smtpd`` module deprecated in Python 3.4.7
+* Remove the ``asyncore``-based ``smtpd`` module deprecated in Python 3.4.7
   and 3.5.4.  A recommended replacement is the
   :mod:`asyncio`-based aiosmtpd_ PyPI module.
 
@@ -1761,7 +1761,7 @@ New Features
 ------------
 
 
-* :pep:`697`: Introduced the :ref:`Unstable C API tier <unstable-c-api>`,
+* :pep:`697`: Introduce the :ref:`Unstable C API tier <unstable-c-api>`,
   intended for low-level tools like debuggers and JIT compilers.
   This API may change in each minor release of CPython without deprecation
   warnings.
@@ -1783,7 +1783,7 @@ New Features
 
   (Contributed by Petr Viktorin in :gh:`101101`.)
 
-* :pep:`697`: Added API for extending types whose instance memory layout is
+* :pep:`697`: Add an API for extending types whose instance memory layout is
   opaque:
 
   - :c:member:`PyType_Spec.basicsize` can be zero or negative to specify
@@ -1798,7 +1798,7 @@ New Features
 
   (Contributed by Petr Viktorin in :gh:`103509`.)
 
-* Added the new :ref:`limited C API <limited-c-api>` function :c:func:`PyType_FromMetaclass`,
+* Add the new :ref:`limited C API <limited-c-api>` function :c:func:`PyType_FromMetaclass`,
   which generalizes the existing :c:func:`PyType_FromModuleAndSpec` using
   an additional metaclass argument.
   (Contributed by Wenzel Jakob in :gh:`93012`.)
@@ -1837,13 +1837,13 @@ New Features
   protocol are now available in the :ref:`Limited API <stable>`. (Contributed
   by Wenzel Jakob in :gh:`98586`.)
 
-* Added two new public functions,
+* Add two new public functions,
   :c:func:`PyEval_SetProfileAllThreads` and
   :c:func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling
   functions in all running threads in addition to the calling one. (Contributed
   by Pablo Galindo in :gh:`93503`.)
 
-* Added new function :c:func:`PyFunction_SetVectorcall` to the C API
+* Add new function :c:func:`PyFunction_SetVectorcall` to the C API
   which sets the vectorcall field of a given :c:type:`PyFunctionObject`.
   (Contributed by Andrew Frost in :gh:`92257`.)
 
@@ -1853,11 +1853,11 @@ New Features
   compilers, or debuggers.
   (Contributed by Carl Meyer in :gh:`91052`.)
 
-* Added :c:func:`PyType_AddWatcher` and :c:func:`PyType_Watch` API to register
+* Add :c:func:`PyType_AddWatcher` and :c:func:`PyType_Watch` API to register
   callbacks to receive notification on changes to a type.
   (Contributed by Carl Meyer in :gh:`91051`.)
 
-* Added :c:func:`PyCode_AddWatcher` and :c:func:`PyCode_ClearWatcher`
+* Add :c:func:`PyCode_AddWatcher` and :c:func:`PyCode_ClearWatcher`
   APIs to register callbacks to receive notification on creation and
   destruction of code objects.
   (Contributed by Itamar Oren in :gh:`91054`.)
@@ -1887,8 +1887,8 @@ New Features
   to replace the legacy-api :c:func:`!PyErr_Display`. (Contributed by
   Irit Katriel in :gh:`102755`).
 
-* :pep:`683`: Introduced Immortal Objects to Python which allows objects
-  to bypass reference counts and introduced changes to the C-API:
+* :pep:`683`: Introduce *Immortal Objects*, which allows objects
+  to bypass reference counts, and related changes to the C-API:
 
   - ``_Py_IMMORTAL_REFCNT``: The reference count that defines an object
       as immortal.
@@ -1905,7 +1905,7 @@ New Features
 
   (Contributed by Eddie Elizondo in :gh:`84436`.)
 
-* :pep:`684`: Added the new :c:func:`Py_NewInterpreterFromConfig`
+* :pep:`684`: Add the new :c:func:`Py_NewInterpreterFromConfig`
   function and :c:type:`PyInterpreterConfig`, which may be used
   to create sub-interpreters with their own GILs.
   (See :ref:`whatsnew312-pep684` for more info.)
@@ -1954,7 +1954,7 @@ Porting to Python 3.12
   copied as-is to the result string, and any extra arguments discarded.
   (Contributed by Serhiy Storchaka in :gh:`95781`.)
 
-* Fixed wrong sign placement in :c:func:`PyUnicode_FromFormat` and
+* Fix wrong sign placement in :c:func:`PyUnicode_FromFormat` and
   :c:func:`PyUnicode_FromFormatV`.
   (Contributed by Philip Georgi in :gh:`95504`.)