Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit 8d365b6

Browse filesBrowse files
AA-Turnerhugovk
andauthored
GH-109190: Copyedit 3.12 What's New: Use the :file: role (#109756)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
1 parent 19601ef commit 8d365b6
Copy full SHA for 8d365b6

File tree

1 file changed

+11
-11
lines changed
Filter options

1 file changed

+11
-11
lines changed

‎Doc/whatsnew/3.12.rst

Copy file name to clipboardExpand all lines: Doc/whatsnew/3.12.rst
+11-11Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1583,7 +1583,7 @@ zipimport
15831583
Others
15841584
------
15851585

1586-
* Removed the ``suspicious`` rule from the documentation Makefile, and
1586+
* Removed the ``suspicious`` rule from the documentation :file:`Makefile`, and
15871587
removed ``Doc/tools/rstlint.py``, both in favor of `sphinx-lint
15881588
<https://github.com/sphinx-contrib/sphinx-lint>`_.
15891589
(Contributed by Julien Palard in :gh:`98179`.)
@@ -1710,9 +1710,9 @@ Changes in the Python API
17101710
Build Changes
17111711
=============
17121712

1713-
* Python no longer uses ``setup.py`` to build shared C extension modules.
1713+
* Python no longer uses :file:`setup.py` to build shared C extension modules.
17141714
Build parameters like headers and libraries are detected in ``configure``
1715-
script. Extensions are built by ``Makefile``. Most extensions use
1715+
script. Extensions are built by :file:`Makefile`. Most extensions use
17161716
``pkg-config`` and fall back to manual detection.
17171717
(Contributed by Christian Heimes in :gh:`93939`.)
17181718

@@ -1725,7 +1725,7 @@ Build Changes
17251725
if the Clang compiler accepts the flag.
17261726
(Contributed by Donghee Na in :gh:`89536`.)
17271727

1728-
* Add ``COMPILEALL_OPTS`` variable in Makefile to override :mod:`compileall`
1728+
* Add ``COMPILEALL_OPTS`` variable in :file:`Makefile` to override :mod:`compileall`
17291729
options (default: ``-j0``) in ``make install``. Also merged the 3
17301730
``compileall`` commands into a single command to build .pyc files for all
17311731
optimization levels (0, 1, 2) at once.
@@ -1892,7 +1892,7 @@ New Features
18921892
- ``SSTATE_INTERNED_IMMORTAL_STATIC`` An identifier for interned unicode
18931893
objects that are immortal and static
18941894
- ``sys.getunicodeinternedsize`` This returns the total number of unicode
1895-
objects that have been interned. This is now needed for refleak.py to
1895+
objects that have been interned. This is now needed for :file:`refleak.py` to
18961896
correctly track reference counts and allocated blocks
18971897

18981898
(Contributed by Eddie Elizondo in :gh:`84436`.)
@@ -2083,10 +2083,10 @@ Deprecated
20832083
* Creating immutable types (:c:macro:`Py_TPFLAGS_IMMUTABLETYPE`) with mutable
20842084
bases is deprecated and will be disabled in Python 3.14.
20852085

2086-
* The ``structmember.h`` header is deprecated, though it continues to be
2086+
* The :file:`structmember.h` header is deprecated, though it continues to be
20872087
available and there are no plans to remove it.
20882088

2089-
Its contents are now available just by including ``Python.h``,
2089+
Its contents are now available just by including :file:`Python.h`,
20902090
with a ``Py`` prefix added if it was missing:
20912091

20922092
- :c:struct:`PyMemberDef`, :c:func:`PyMember_GetOne` and
@@ -2096,14 +2096,14 @@ Deprecated
20962096
- The flags :c:macro:`Py_READONLY` (previously ``READONLY``) and
20972097
:c:macro:`Py_AUDIT_READ` (previously all uppercase)
20982098

2099-
Several items are not exposed from ``Python.h``:
2099+
Several items are not exposed from :file:`Python.h`:
21002100

21012101
- :c:macro:`T_OBJECT` (use :c:macro:`Py_T_OBJECT_EX`)
21022102
- :c:macro:`T_NONE` (previously undocumented, and pretty quirky)
21032103
- The macro ``WRITE_RESTRICTED`` which does nothing.
21042104
- The macros ``RESTRICTED`` and ``READ_RESTRICTED``, equivalents of
21052105
:c:macro:`Py_AUDIT_READ`.
2106-
- In some configurations, ``<stddef.h>`` is not included from ``Python.h``.
2106+
- In some configurations, ``<stddef.h>`` is not included from :file:`Python.h`.
21072107
It should be included manually when using ``offsetof()``.
21082108

21092109
The deprecated header continues to provide its original
@@ -2133,8 +2133,8 @@ Deprecated
21332133
Removed
21342134
-------
21352135

2136-
* Remove the ``token.h`` header file. There was never any public tokenizer C
2137-
API. The ``token.h`` header file was only designed to be used by Python
2136+
* Remove the :file:`token.h` header file. There was never any public tokenizer C
2137+
API. The :file:`token.h` header file was only designed to be used by Python
21382138
internals.
21392139
(Contributed by Victor Stinner in :gh:`92651`.)
21402140

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.