https://github.com/python/cpython/commit/22cb9ba8f90bfbc0b8831365b6864f41b19d0b6e
commit: 22cb9ba8f90bfbc0b8831365b6864f41b19d0b6e
branch: main
author: Adam Turner <[email protected]>
committer: AA-Turner <[email protected]>
date: 2025-09-08T22:10:26Z
summary:
GH-101100: Remove some entries from ``nitpick_ignore`` (#138464)
files:
M Doc/conf.py
M Doc/library/collections.rst
M Doc/library/dataclasses.rst
M Doc/library/dis.rst
M Doc/library/inspect.rst
M Doc/library/os.path.rst
M Doc/library/pathlib.rst
M Doc/library/stdtypes.rst
M Doc/reference/compound_stmts.rst
M Doc/tools/check-warnings.py
M Doc/tutorial/controlflow.rst
M Doc/whatsnew/3.2.rst
M Doc/whatsnew/3.4.rst
M Doc/whatsnew/3.5.rst
M Doc/whatsnew/3.6.rst
M Misc/NEWS.d/3.12.0a1.rst
M Misc/NEWS.d/3.13.0a6.rst
M Misc/NEWS.d/3.14.0a7.rst
diff --git a/Doc/conf.py b/Doc/conf.py
index bdc3ad13617948..c1b07df08b1782 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -221,13 +221,6 @@
('envvar', 'USER'),
('envvar', 'USERNAME'),
('envvar', 'USERPROFILE'),
- # Deprecated function that was never documented:
- ('py:func', 'getargspec'),
- ('py:func', 'inspect.getargspec'),
- # Undocumented modules that users shouldn't have to worry about
- # (implementation details of `os.path`):
- ('py:mod', 'ntpath'),
- ('py:mod', 'posixpath'),
]
# Temporary undocumented names.
@@ -242,8 +235,6 @@
('py:meth', '_SubParsersAction.add_parser'),
# Attributes/methods/etc. that definitely should be documented better,
# but are deferred for now:
- ('py:attr', '__annotations__'),
- ('py:meth', '__missing__'),
('py:attr', '__wrapped__'),
]
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index 17ca8b99db0235..fdd31799bd90d3 100644
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -758,9 +758,9 @@ stack manipulations such as ``dup``, ``drop``, ``swap``,
``over``, ``pick``,
.. attribute:: default_factory
- This attribute is used by the :meth:`__missing__` method; it is
- initialized from the first argument to the constructor, if present, or
to
- ``None``, if absent.
+ This attribute is used by the :meth:`~defaultdict.__missing__` method;
+ it is initialized from the first argument to the constructor, if
present,
+ or to ``None``, if absent.
.. versionchanged:: 3.9
Added merge (``|``) and update (``|=``) operators, specified in
diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst
index 2e4520c823bf3e..ca432f2768a127 100644
--- a/Doc/library/dataclasses.rst
+++ b/Doc/library/dataclasses.rst
@@ -439,7 +439,7 @@ Module contents
function is used.
This function is not strictly required, because any Python
- mechanism for creating a new class with :attr:`!__annotations__` can
+ mechanism for creating a new class with :attr:`~object.__annotations__` can
then apply the :func:`@dataclass <dataclass>` function to convert that
class to
a dataclass. This function is provided as a convenience. For
example::
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 7360f4aa804724..21bd1db5f338de 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -1086,6 +1086,11 @@ iterations of the loop.
Pushes ``co_consts[consti]`` onto the stack.
+.. opcode:: LOAD_CONST_IMMORTAL (consti)
+
+ Works as :opcode:`LOAD_CONST`, but is more efficient for immortal objects.
+
+
.. opcode:: LOAD_SMALL_INT (i)
Pushes the integer ``i`` onto the stack.
diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
index 1061ae8849f48f..7f2930ccd5523a 100644
--- a/Doc/library/inspect.rst
+++ b/Doc/library/inspect.rst
@@ -1179,7 +1179,7 @@ Classes and functions
:func:`signature` in Python 3.5, but that decision has been reversed
in order to restore a clearly supported standard interface for
single-source Python 2/3 code migrating away from the legacy
- :func:`getargspec` API.
+ :func:`!getargspec` API.
.. versionchanged:: 3.7
Python only explicitly guaranteed that it preserved the declaration
diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index cb021be4543e75..bb9a7c86464050 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -42,8 +42,8 @@ the :mod:`glob` module.)
a path that is *always* in one of the different formats. They all have the
same interface:
- * :mod:`posixpath` for UNIX-style paths
- * :mod:`ntpath` for Windows paths
+ * :mod:`!posixpath` for UNIX-style paths
+ * :mod:`!ntpath` for Windows paths
.. versionchanged:: 3.8
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index ebf5756146df92..79e0b7f09eaa77 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -311,7 +311,7 @@ Pure paths provide the following methods and properties:
.. attribute:: PurePath.parser
The implementation of the :mod:`os.path` module used for low-level path
- parsing and joining: either :mod:`posixpath` or :mod:`ntpath`.
+ parsing and joining: either :mod:`!posixpath` or :mod:`!ntpath`.
.. versionadded:: 3.13
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 3ea4edacf3d0cc..b30b7fef9089f1 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -5014,13 +5014,13 @@ can be used interchangeably to index the same
dictionary entry.
.. index:: __missing__()
- If a subclass of dict defines a method :meth:`__missing__` and *key*
+ If a subclass of dict defines a method :meth:`~object.__missing__` and
*key*
is not present, the ``d[key]`` operation calls that method with the key
*key*
as argument. The ``d[key]`` operation then returns or raises whatever is
returned or raised by the ``__missing__(key)`` call.
- No other operations or methods invoke :meth:`__missing__`. If
- :meth:`__missing__` is not defined, :exc:`KeyError` is raised.
- :meth:`__missing__` must be a method; it cannot be an instance variable::
+ No other operations or methods invoke :meth:`~object.__missing__`. If
+ :meth:`~object.__missing__` is not defined, :exc:`KeyError` is raised.
+ :meth:`~object.__missing__` must be a method; it cannot be an instance
variable::
>>> class Counter(dict):
... def __missing__(self, key):
@@ -5034,7 +5034,8 @@ can be used interchangeably to index the same dictionary
entry.
1
The example above shows part of the implementation of
- :class:`collections.Counter`. A different ``__missing__`` method is used
+ :class:`collections.Counter`.
+ A different :meth:`!__missing__` method is used
by :class:`collections.defaultdict`.
.. describe:: d[key] = value
diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst
index 9dca276e4a0001..283b3b1bc6d86e 100644
--- a/Doc/reference/compound_stmts.rst
+++ b/Doc/reference/compound_stmts.rst
@@ -1067,8 +1067,8 @@ subject value:
.. note:: Key-value pairs are matched using the two-argument form of the
mapping
subject's ``get()`` method. Matched key-value pairs must already be present
- in the mapping, and not created on-the-fly via :meth:`__missing__` or
- :meth:`~object.__getitem__`.
+ in the mapping, and not created on-the-fly via :meth:`~object.__missing__`
+ or :meth:`~object.__getitem__`.
In simple terms ``{KEY1: P1, KEY2: P2, ... }`` matches only if all the
following
happens:
diff --git a/Doc/tools/check-warnings.py b/Doc/tools/check-warnings.py
index c686eecf8d9271..2f2bb9e2dcb7ef 100644
--- a/Doc/tools/check-warnings.py
+++ b/Doc/tools/check-warnings.py
@@ -15,7 +15,7 @@
from typing import TextIO
# Fail if NEWS nit found before this line number
-NEWS_NIT_THRESHOLD = 1700
+NEWS_NIT_THRESHOLD = 8550
# Exclude these whether they're dirty or clean,
# because they trigger a rebuild of dirty files.
diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst
index b4b9d36cef1754..5ec8789f98c701 100644
--- a/Doc/tutorial/controlflow.rst
+++ b/Doc/tutorial/controlflow.rst
@@ -1081,7 +1081,7 @@ Function Annotations
information about the types used by user-defined functions (see :pep:`3107` and
:pep:`484` for more information).
-:term:`Annotations <function annotation>` are stored in the
:attr:`!__annotations__`
+:term:`Annotations <function annotation>` are stored in the
:attr:`~object.__annotations__`
attribute of the function as a dictionary and have no effect on any other part
of the
function. Parameter annotations are defined by a colon after the parameter
name, followed
by an expression evaluating to the value of the annotation. Return
annotations are
diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst
index 7104904c956a7a..47c4d9acbc870e 100644
--- a/Doc/whatsnew/3.2.rst
+++ b/Doc/whatsnew/3.2.rst
@@ -458,7 +458,7 @@ Some smaller changes made to the core Python language are:
:class:`~collections.defaultdict`, :class:`~shelve.Shelf`,
:class:`~configparser.ConfigParser`, or :mod:`dbm`. It is also useful with
custom :class:`dict` subclasses that normalize keys before look-up or that
- supply a :meth:`__missing__` method for unknown keys::
+ supply a :meth:`~object.__missing__` method for unknown keys::
>>> import shelve
>>> d = shelve.open('tmp.shl')
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index 5ad4f1c4a5e494..59afd6520c418f 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -1039,7 +1039,7 @@ As part of the implementation of the new :mod:`enum`
module, the
metaclasses. (Contributed by Ethan Furman in :issue:`18929` and
:issue:`19030`.)
-:func:`~inspect.getfullargspec` and :func:`~inspect.getargspec`
+:func:`~inspect.getfullargspec` and :func:`!getargspec`
now use the :func:`~inspect.signature` API. This allows them to
support a much broader range of callables, including those with
``__signature__`` attributes, those with metadata provided by argument
diff --git a/Doc/whatsnew/3.5.rst b/Doc/whatsnew/3.5.rst
index d7af63497a0256..59e8ecebb10444 100644
--- a/Doc/whatsnew/3.5.rst
+++ b/Doc/whatsnew/3.5.rst
@@ -2324,7 +2324,7 @@ The previously undocumented ``from_function`` and
``from_builtin`` methods of
:meth:`Signature.from_callable() <inspect.Signature.from_callable>`
method instead. (Contributed by Yury Selivanov in :issue:`24248`.)
-The :func:`inspect.getargspec` function is deprecated and scheduled to be
+The :func:`!inspect.getargspec` function is deprecated and scheduled to be
removed in Python 3.6. (See :issue:`20438` for details.)
The :mod:`inspect` :func:`~inspect.getfullargspec`,
diff --git a/Doc/whatsnew/3.6.rst b/Doc/whatsnew/3.6.rst
index 308596498b071a..b1e3269239d629 100644
--- a/Doc/whatsnew/3.6.rst
+++ b/Doc/whatsnew/3.6.rst
@@ -1224,7 +1224,7 @@ generator expression scopes as if they were
positional-only parameters called
``implicit0``. (Contributed by Jelle Zijlstra in :issue:`19611`.)
To reduce code churn when upgrading from Python 2.7 and the legacy
-:func:`inspect.getargspec` API, the previously documented deprecation of
+:func:`!inspect.getargspec` API, the previously documented deprecation of
:func:`inspect.getfullargspec` has been reversed. While this function is
convenient for single/source Python 2/3 code bases, the richer
:func:`inspect.signature` interface remains the recommended approach for new
diff --git a/Misc/NEWS.d/3.12.0a1.rst b/Misc/NEWS.d/3.12.0a1.rst
index f2668e99a6299b..0da7cdde1b2535 100644
--- a/Misc/NEWS.d/3.12.0a1.rst
+++ b/Misc/NEWS.d/3.12.0a1.rst
@@ -4330,7 +4330,7 @@ and ``sendfile`` inside ``IocpProactor``.
.. nonce: GsBL9-
.. section: Library
-Fixed :meth:`collections.UserDict.get` to not call :meth:`__missing__` when
+Fixed :meth:`collections.UserDict.get` to not call :meth:`~object.__missing__`
when
a value is not found. This matches the behavior of :class:`dict`. Patch by
Bar Harel.
diff --git a/Misc/NEWS.d/3.13.0a6.rst b/Misc/NEWS.d/3.13.0a6.rst
index 2740b4f0d967ba..ad6622d23bf36b 100644
--- a/Misc/NEWS.d/3.13.0a6.rst
+++ b/Misc/NEWS.d/3.13.0a6.rst
@@ -264,7 +264,8 @@ Improve performance of :func:`os.path.join` and
:func:`os.path.expanduser`.
.. nonce: hqk9Hn
.. section: Library
-Raise :exc:`TypeError` for non-paths in :func:`posixpath.relpath`.
+Raise :exc:`TypeError` for non-paths in :func:`posixpath.relpath
+<os.path.relpath>`.
..
@@ -273,7 +274,8 @@ Raise :exc:`TypeError` for non-paths in
:func:`posixpath.relpath`.
.. nonce: l6rWlj
.. section: Library
-Preserve mailbox ownership when rewriting in :func:`mailbox.mbox.flush`.
+Preserve mailbox ownership when rewriting in :func:`mailbox.mbox.flush
+<mailbox.Mailbox.flush>`.
Patch by Tony Mountifield.
..
diff --git a/Misc/NEWS.d/3.14.0a7.rst b/Misc/NEWS.d/3.14.0a7.rst
index ab64bdbb319027..946ca27046a745 100644
--- a/Misc/NEWS.d/3.14.0a7.rst
+++ b/Misc/NEWS.d/3.14.0a7.rst
@@ -192,7 +192,7 @@ The :class:`ctypes.py_object` type now supports
subscription, making it a
.. nonce: cX4yTn
.. section: Library
-Add the :attr:`zipfile.ZipFile.data_offset` attribute, which stores the
+Add the :attr:`!zipfile.ZipFile.data_offset` attribute, which stores the
offset to the beginning of ZIP data in a file when available. When the
:class:`zipfile.ZipFile` is opened in either mode ``'w'`` or ``'x'`` and the
underlying file does not support ``tell()``, the value will be ``None``
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
