Skip to content

Commit de6d17c

Browse files
[3.12] GH-109190: Copyedit 3.12 What's New: Use the present tense (GH-109754) (#109827)
GH-109190: Copyedit 3.12 What's New: Use the present tense (GH-109754) (cherry picked from commit 4e47853) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
1 parent d4dd8a1 commit de6d17c

File tree

1 file changed

+30
-30
lines changed

1 file changed

+30
-30
lines changed

Doc/whatsnew/3.12.rst

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -570,7 +570,7 @@ asyncio
570570
writing to sockets and uses :meth:`~socket.socket.sendmsg` if the platform
571571
supports it. (Contributed by Kumar Aditya in :gh:`91166`.)
572572

573-
* Added :func:`asyncio.eager_task_factory` and :func:`asyncio.create_eager_task_factory`
573+
* Add :func:`asyncio.eager_task_factory` and :func:`asyncio.create_eager_task_factory`
574574
functions to allow opting an event loop in to eager task execution,
575575
making some use-cases 2x to 5x faster.
576576
(Contributed by Jacob Bower & Itamar Oren in :gh:`102853`, :gh:`104140`, and :gh:`104138`)
@@ -666,17 +666,17 @@ inspect
666666
itertools
667667
---------
668668

669-
* Added :class:`itertools.batched()` for collecting into even-sized
669+
* Add :class:`itertools.batched()` for collecting into even-sized
670670
tuples where the last batch may be shorter than the rest.
671671
(Contributed by Raymond Hettinger in :gh:`98363`.)
672672

673673
math
674674
----
675675

676-
* Added :func:`math.sumprod` for computing a sum of products.
676+
* Add :func:`math.sumprod` for computing a sum of products.
677677
(Contributed by Raymond Hettinger in :gh:`100485`.)
678678

679-
* Extended :func:`math.nextafter` to include a *steps* argument
679+
* Extend :func:`math.nextafter` to include a *steps* argument
680680
for moving up or down multiple steps at a time.
681681
(By Matthias Goergens, Mark Dickinson, and Raymond Hettinger in :gh:`94906`.)
682682

@@ -749,10 +749,10 @@ pdb
749749
random
750750
------
751751

752-
* Added :func:`random.binomialvariate`.
752+
* Add :func:`random.binomialvariate`.
753753
(Contributed by Raymond Hettinger in :gh:`81620`.)
754754

755-
* Added a default of ``lamb=1.0`` to :func:`random.expovariate`.
755+
* Add a default of ``lamb=1.0`` to :func:`random.expovariate`.
756756
(Contributed by Raymond Hettinger in :gh:`100234`.)
757757

758758
shutil
@@ -811,7 +811,7 @@ sqlite3
811811
statistics
812812
----------
813813

814-
* Extended :func:`statistics.correlation` to include as a ``ranked`` method
814+
* Extend :func:`statistics.correlation` to include as a ``ranked`` method
815815
for computing the Spearman correlation of ranked data.
816816
(Contributed by Raymond Hettinger in :gh:`95861`.)
817817

@@ -949,7 +949,7 @@ unicodedata
949949
unittest
950950
--------
951951

952-
Added ``--durations`` command line option, showing the N slowest test cases::
952+
Add a ``--durations`` command line option, showing the N slowest test cases::
953953

954954
python3 -m unittest --durations=3 lib.tests.test_threading
955955
.....
@@ -977,11 +977,11 @@ uuid
977977
Optimizations
978978
=============
979979

980-
* Removed ``wstr`` and ``wstr_length`` members from Unicode objects.
980+
* Remove ``wstr`` and ``wstr_length`` members from Unicode objects.
981981
It reduces object size by 8 or 16 bytes on 64bit platform. (:pep:`623`)
982982
(Contributed by Inada Naoki in :gh:`92536`.)
983983

984-
* Added experimental support for using the BOLT binary optimizer in the build
984+
* Add experimental support for using the BOLT binary optimizer in the build
985985
process, which improves performance by 1-5%.
986986
(Contributed by Kevin Modzelewski in :gh:`90536` and tuned by Donghee Na in :gh:`101525`)
987987

@@ -1014,7 +1014,7 @@ CPython bytecode changes
10141014
* Remove the :opcode:`!JUMP_IF_FALSE_OR_POP` and :opcode:`!JUMP_IF_TRUE_OR_POP`
10151015
instructions. (Contributed by Irit Katriel in :gh:`102859`.)
10161016

1017-
* Removed the :opcode:`!PRECALL` instruction. (Contributed by Mark Shannon in
1017+
* Remove the :opcode:`!PRECALL` instruction. (Contributed by Mark Shannon in
10181018
:gh:`92925`.)
10191019

10201020
* Add the :opcode:`LOAD_FAST_AND_CLEAR` instruction as part of the
@@ -1440,9 +1440,9 @@ imp
14401440
loader.exec_module(module)
14411441
return module
14421442

1443-
* Removed :mod:`!imp` functions and attributes with no replacements:
1443+
* Remove :mod:`!imp` functions and attributes with no replacements:
14441444

1445-
* undocumented functions:
1445+
* Undocumented functions:
14461446

14471447
* ``imp.init_builtin()``
14481448
* ``imp.load_compiled()``
@@ -1523,7 +1523,7 @@ ssl
15231523
unittest
15241524
--------
15251525

1526-
* Removed many old deprecated :mod:`unittest` features:
1526+
* Remove many long-deprecated :mod:`unittest` features:
15271527

15281528
* A number of :class:`~unittest.TestCase` method aliases:
15291529

@@ -1566,7 +1566,7 @@ webbrowser
15661566
----------
15671567

15681568
* Remove support for obsolete browsers from :mod:`webbrowser`.
1569-
Removed browsers include: Grail, Mosaic, Netscape, Galeon, Skipstone,
1569+
The removed browsers include: Grail, Mosaic, Netscape, Galeon, Skipstone,
15701570
Iceape, Firebird, and Firefox versions 35 and below (:gh:`102871`).
15711571

15721572
xml.etree.ElementTree
@@ -1589,8 +1589,8 @@ zipimport
15891589
Others
15901590
------
15911591

1592-
* Removed the ``suspicious`` rule from the documentation :file:`Makefile`, and
1593-
removed ``Doc/tools/rstlint.py``, both in favor of `sphinx-lint
1592+
* Remove the ``suspicious`` rule from the documentation :file:`Makefile` and
1593+
:file:`Doc/tools/rstlint.py`, both in favor of `sphinx-lint
15941594
<https://github.com/sphinx-contrib/sphinx-lint>`_.
15951595
(Contributed by Julien Palard in :gh:`98179`.)
15961596

@@ -1620,7 +1620,7 @@ Changes in the Python API
16201620
contain ASCII letters and digits and underscore.
16211621
(Contributed by Serhiy Storchaka in :gh:`91760`.)
16221622

1623-
* Removed ``randrange()`` functionality deprecated since Python 3.10. Formerly,
1623+
* Remove ``randrange()`` functionality deprecated since Python 3.10. Formerly,
16241624
``randrange(10.0)`` losslessly converted to ``randrange(10)``. Now, it raises a
16251625
:exc:`TypeError`. Also, the exception raised for non-integer values such as
16261626
``randrange(10.5)`` or ``randrange('10')`` has been changed from :exc:`ValueError` to
@@ -1634,7 +1634,7 @@ Changes in the Python API
16341634
to :term:`filesystem encoding and error handler`.
16351635
Argument files should be encoded in UTF-8 instead of ANSI Codepage on Windows.
16361636

1637-
* Removed the ``asyncore``-based ``smtpd`` module deprecated in Python 3.4.7
1637+
* Remove the ``asyncore``-based ``smtpd`` module deprecated in Python 3.4.7
16381638
and 3.5.4. A recommended replacement is the
16391639
:mod:`asyncio`-based aiosmtpd_ PyPI module.
16401640

@@ -1761,7 +1761,7 @@ New Features
17611761
------------
17621762

17631763

1764-
* :pep:`697`: Introduced the :ref:`Unstable C API tier <unstable-c-api>`,
1764+
* :pep:`697`: Introduce the :ref:`Unstable C API tier <unstable-c-api>`,
17651765
intended for low-level tools like debuggers and JIT compilers.
17661766
This API may change in each minor release of CPython without deprecation
17671767
warnings.
@@ -1783,7 +1783,7 @@ New Features
17831783

17841784
(Contributed by Petr Viktorin in :gh:`101101`.)
17851785

1786-
* :pep:`697`: Added API for extending types whose instance memory layout is
1786+
* :pep:`697`: Add an API for extending types whose instance memory layout is
17871787
opaque:
17881788

17891789
- :c:member:`PyType_Spec.basicsize` can be zero or negative to specify
@@ -1798,7 +1798,7 @@ New Features
17981798

17991799
(Contributed by Petr Viktorin in :gh:`103509`.)
18001800

1801-
* Added the new :ref:`limited C API <limited-c-api>` function :c:func:`PyType_FromMetaclass`,
1801+
* Add the new :ref:`limited C API <limited-c-api>` function :c:func:`PyType_FromMetaclass`,
18021802
which generalizes the existing :c:func:`PyType_FromModuleAndSpec` using
18031803
an additional metaclass argument.
18041804
(Contributed by Wenzel Jakob in :gh:`93012`.)
@@ -1837,13 +1837,13 @@ New Features
18371837
protocol are now available in the :ref:`Limited API <stable>`. (Contributed
18381838
by Wenzel Jakob in :gh:`98586`.)
18391839

1840-
* Added two new public functions,
1840+
* Add two new public functions,
18411841
:c:func:`PyEval_SetProfileAllThreads` and
18421842
:c:func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling
18431843
functions in all running threads in addition to the calling one. (Contributed
18441844
by Pablo Galindo in :gh:`93503`.)
18451845

1846-
* Added new function :c:func:`PyFunction_SetVectorcall` to the C API
1846+
* Add new function :c:func:`PyFunction_SetVectorcall` to the C API
18471847
which sets the vectorcall field of a given :c:type:`PyFunctionObject`.
18481848
(Contributed by Andrew Frost in :gh:`92257`.)
18491849

@@ -1853,11 +1853,11 @@ New Features
18531853
compilers, or debuggers.
18541854
(Contributed by Carl Meyer in :gh:`91052`.)
18551855

1856-
* Added :c:func:`PyType_AddWatcher` and :c:func:`PyType_Watch` API to register
1856+
* Add :c:func:`PyType_AddWatcher` and :c:func:`PyType_Watch` API to register
18571857
callbacks to receive notification on changes to a type.
18581858
(Contributed by Carl Meyer in :gh:`91051`.)
18591859

1860-
* Added :c:func:`PyCode_AddWatcher` and :c:func:`PyCode_ClearWatcher`
1860+
* Add :c:func:`PyCode_AddWatcher` and :c:func:`PyCode_ClearWatcher`
18611861
APIs to register callbacks to receive notification on creation and
18621862
destruction of code objects.
18631863
(Contributed by Itamar Oren in :gh:`91054`.)
@@ -1887,8 +1887,8 @@ New Features
18871887
to replace the legacy-api :c:func:`!PyErr_Display`. (Contributed by
18881888
Irit Katriel in :gh:`102755`).
18891889

1890-
* :pep:`683`: Introduced Immortal Objects to Python which allows objects
1891-
to bypass reference counts and introduced changes to the C-API:
1890+
* :pep:`683`: Introduce *Immortal Objects*, which allows objects
1891+
to bypass reference counts, and related changes to the C-API:
18921892

18931893
- ``_Py_IMMORTAL_REFCNT``: The reference count that defines an object
18941894
as immortal.
@@ -1905,7 +1905,7 @@ New Features
19051905

19061906
(Contributed by Eddie Elizondo in :gh:`84436`.)
19071907

1908-
* :pep:`684`: Added the new :c:func:`Py_NewInterpreterFromConfig`
1908+
* :pep:`684`: Add the new :c:func:`Py_NewInterpreterFromConfig`
19091909
function and :c:type:`PyInterpreterConfig`, which may be used
19101910
to create sub-interpreters with their own GILs.
19111911
(See :ref:`whatsnew312-pep684` for more info.)
@@ -1954,7 +1954,7 @@ Porting to Python 3.12
19541954
copied as-is to the result string, and any extra arguments discarded.
19551955
(Contributed by Serhiy Storchaka in :gh:`95781`.)
19561956

1957-
* Fixed wrong sign placement in :c:func:`PyUnicode_FromFormat` and
1957+
* Fix wrong sign placement in :c:func:`PyUnicode_FromFormat` and
19581958
:c:func:`PyUnicode_FromFormatV`.
19591959
(Contributed by Philip Georgi in :gh:`95504`.)
19601960

0 commit comments

Comments
 (0)