mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-01 21:02:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

[3.12] GH-109190: Copyedit 3.12 What's New: Use the `:file:` role (GH-109756) (#109806)

Browse source 
GH-109190: Copyedit 3.12 What's New: Use the ``:file:`` role (GH-109756)
(cherry picked from commit 8d365b60ba)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2023-09-25 03:15:46 -07:00 • committed by GitHub
parent 6f1d4552b3
commit d56835f855
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

22
Doc/whatsnew/3.12.rst
View file

@ -1584,7 +1584,7 @@ zipimport
Others
------
* Removed the ``suspicious`` rule from the documentation Makefile, and
* Removed the ``suspicious`` rule from the documentation :file:`Makefile`, and
removed ``Doc/tools/rstlint.py``, both in favor of `sphinx-lint
<https://github.com/sphinx-contrib/sphinx-lint>`_.
(Contributed by Julien Palard in :gh:`98179`.)
@ -1711,9 +1711,9 @@ Changes in the Python API
Build Changes
=============
* Python no longer uses ``setup.py`` to build shared C extension modules.
* Python no longer uses :file:`setup.py` to build shared C extension modules.
Build parameters like headers and libraries are detected in ``configure``
script. Extensions are built by ``Makefile``. Most extensions use
script. Extensions are built by :file:`Makefile`. Most extensions use
``pkg-config`` and fall back to manual detection.
(Contributed by Christian Heimes in :gh:`93939`.)
@ -1726,7 +1726,7 @@ Build Changes
if the Clang compiler accepts the flag.
(Contributed by Donghee Na in :gh:`89536`.)
* Add ``COMPILEALL_OPTS`` variable in Makefile to override :mod:`compileall`
* Add ``COMPILEALL_OPTS`` variable in :file:`Makefile` to override :mod:`compileall`
options (default: ``-j0``) in ``make install``. Also merged the 3
``compileall`` commands into a single command to build .pyc files for all
optimization levels (0, 1, 2) at once.
@ -1895,7 +1895,7 @@ New Features
- ``SSTATE_INTERNED_IMMORTAL_STATIC`` An identifier for interned unicode
objects that are immortal and static
- ``sys.getunicodeinternedsize`` This returns the total number of unicode
objects that have been interned. This is now needed for refleak.py to
objects that have been interned. This is now needed for :file:`refleak.py` to
correctly track reference counts and allocated blocks
(Contributed by Eddie Elizondo in :gh:`84436`.)
@ -2086,10 +2086,10 @@ Deprecated
* Creating immutable types (:c:macro:`Py_TPFLAGS_IMMUTABLETYPE`) with mutable
bases is deprecated and will be disabled in Python 3.14.
* The ``structmember.h`` header is deprecated, though it continues to be
* The :file:`structmember.h` header is deprecated, though it continues to be
available and there are no plans to remove it.
Its contents are now available just by including ``Python.h``,
Its contents are now available just by including :file:`Python.h`,
with a ``Py`` prefix added if it was missing:
- :c:struct:`PyMemberDef`, :c:func:`PyMember_GetOne` and
@ -2099,14 +2099,14 @@ Deprecated
- The flags :c:macro:`Py_READONLY` (previously ``READONLY``) and
:c:macro:`Py_AUDIT_READ` (previously all uppercase)
Several items are not exposed from ``Python.h``:
Several items are not exposed from :file:`Python.h`:
- :c:macro:`T_OBJECT` (use :c:macro:`Py_T_OBJECT_EX`)
- :c:macro:`T_NONE` (previously undocumented, and pretty quirky)
- The macro ``WRITE_RESTRICTED`` which does nothing.
- The macros ``RESTRICTED`` and ``READ_RESTRICTED``, equivalents of
:c:macro:`Py_AUDIT_READ`.
- In some configurations, ``<stddef.h>`` is not included from ``Python.h``.
- In some configurations, ``<stddef.h>`` is not included from :file:`Python.h`.
It should be included manually when using ``offsetof()``.
The deprecated header continues to provide its original
@ -2136,8 +2136,8 @@ Deprecated
Removed
-------
* Remove the ``token.h`` header file. There was never any public tokenizer C
API. The ``token.h`` header file was only designed to be used by Python
* Remove the :file:`token.h` header file. There was never any public tokenizer C
API. The :file:`token.h` header file was only designed to be used by Python
internals.
(Contributed by Victor Stinner in :gh:`92651`.)