Skip to content

Commit 21a537b

Browse files
AA-TurnerGlyphack
authored andcommitted
pythonGH-109190: Copyedit 3.12 What's New: Use the present tense (python#109754)
1 parent 8ac094b commit 21a537b

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
@@ -1441,9 +1441,9 @@ imp
14411441
loader.exec_module(module)
14421442
return module
14431443

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

1446-
* undocumented functions:
1446+
* Undocumented functions:
14471447

14481448
* ``imp.init_builtin()``
14491449
* ``imp.load_compiled()``
@@ -1524,7 +1524,7 @@ ssl
15241524
unittest
15251525
--------
15261526

1527-
* Removed many old deprecated :mod:`unittest` features:
1527+
* Remove many long-deprecated :mod:`unittest` features:
15281528

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

@@ -1567,7 +1567,7 @@ webbrowser
15671567
----------
15681568

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

15731573
xml.etree.ElementTree
@@ -1590,8 +1590,8 @@ zipimport
15901590
Others
15911591
------
15921592

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

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

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

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

@@ -1760,7 +1760,7 @@ New Features
17601760
------------
17611761

17621762

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

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

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

17881788
- :c:member:`PyType_Spec.basicsize` can be zero or negative to specify
@@ -1797,7 +1797,7 @@ New Features
17971797

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

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

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

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

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

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

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

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

18921892
- ``_Py_IMMORTAL_REFCNT``: The reference count that defines an object
18931893
as immortal.
@@ -1904,7 +1904,7 @@ New Features
19041904

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

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

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

0 commit comments

Comments
 (0)