pythonGH-109190: Copyedit 3.12 What's New: Use the :file: role (p…

…ythonGH-109756)

(cherry picked from commit 8d365b6)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

Doc/whatsnew/3.12.rst

@@ -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`.)