From 96954f760e41f74d91dbd6762c0169dacd6ea434 Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Wed, 3 Jun 2026 23:54:32 +0200 Subject: [PATCH 1/2] Docs: improve class references linking in functions.rst With Linklint we link only first reference in a paragraph. Explicitly leave only reference which is expected to link. In dict, frozendict, frozenset and set reference docs. --- Doc/library/functions.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index ebf2dea1c1f80c..551d76ee8c8a93 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -484,7 +484,7 @@ are always available. They are listed here in alphabetical order. dict(iterable, /, **kwargs) :noindex: - Create a new dictionary. The :class:`dict` object is the dictionary class. + Create a new dictionary. The :class:`!dict` object is the dictionary class. See :class:`dict` and :ref:`typesmapping` for documentation about this class. For other containers see the built-in :class:`frozendict`, :class:`list`, @@ -872,7 +872,7 @@ are always available. They are listed here in alphabetical order. frozendict(iterable, /, **kwargs) :noindex: - Create a new frozen dictionary. The :class:`frozendict` object is a built-in class. + Create a new frozen dictionary. The :class:`!frozendict` object is a built-in class. See :class:`frozendict` and :ref:`typesmapping` for documentation about this class. For other containers see the built-in :class:`dict`, :class:`list`, :class:`set`, @@ -885,8 +885,8 @@ are always available. They are listed here in alphabetical order. .. class:: frozenset(iterable=(), /) :noindex: - Return a new :class:`frozenset` object, optionally with elements taken from - *iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and + Return a new :class:`!frozenset` object, optionally with elements taken from + *iterable*. :class:`!frozenset` is a built-in class. See :class:`frozenset` and :ref:`types-set` for documentation about this class. For other containers see the built-in :class:`set`, :class:`list`, @@ -1813,8 +1813,8 @@ are always available. They are listed here in alphabetical order. .. class:: set(iterable=(), /) :noindex: - Return a new :class:`set` object, optionally with elements taken from - *iterable*. ``set`` is a built-in class. See :class:`set` and + Return a new :class:`!set` object, optionally with elements taken from + *iterable*. :class:`!set` is a built-in class. See :class:`set` and :ref:`types-set` for documentation about this class. For other containers see the built-in :class:`frozenset`, :class:`list`, From de4af58ffea4eb1ad8c5c387fafb10f78c661638 Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Thu, 4 Jun 2026 15:00:44 +0200 Subject: [PATCH 2/2] Rephrase collection built-in functions descriptions to avoid repetitions, revert unreferencing classes names --- Doc/library/functions.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 551d76ee8c8a93..a4d37beb436899 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -484,8 +484,8 @@ are always available. They are listed here in alphabetical order. dict(iterable, /, **kwargs) :noindex: - Create a new dictionary. The :class:`!dict` object is the dictionary class. - See :class:`dict` and :ref:`typesmapping` for documentation about this class. + Create a new dictionary. The :class:`dict` object is the dictionary class. + See also :ref:`typesmapping` for documentation about this class. For other containers see the built-in :class:`frozendict`, :class:`list`, :class:`set`, and :class:`tuple` classes, as well as the :mod:`collections` module. @@ -872,8 +872,8 @@ are always available. They are listed here in alphabetical order. frozendict(iterable, /, **kwargs) :noindex: - Create a new frozen dictionary. The :class:`!frozendict` object is a built-in class. - See :class:`frozendict` and :ref:`typesmapping` for documentation about this class. + Create a new frozen dictionary. The :class:`frozendict` object is a built-in class. + See also :ref:`typesmapping` for documentation about this class. For other containers see the built-in :class:`dict`, :class:`list`, :class:`set`, and :class:`tuple` classes, as well as the :mod:`collections` module. @@ -885,8 +885,8 @@ are always available. They are listed here in alphabetical order. .. class:: frozenset(iterable=(), /) :noindex: - Return a new :class:`!frozenset` object, optionally with elements taken from - *iterable*. :class:`!frozenset` is a built-in class. See :class:`frozenset` and + Return a new :class:`frozenset` object, optionally with elements taken from + *iterable*. :class:`frozenset` is a built-in class. See also :ref:`types-set` for documentation about this class. For other containers see the built-in :class:`set`, :class:`list`, @@ -1813,8 +1813,8 @@ are always available. They are listed here in alphabetical order. .. class:: set(iterable=(), /) :noindex: - Return a new :class:`!set` object, optionally with elements taken from - *iterable*. :class:`!set` is a built-in class. See :class:`set` and + Return a new :class:`set` object, optionally with elements taken from + *iterable*. :class:`set` is a built-in class. See also :ref:`types-set` for documentation about this class. For other containers see the built-in :class:`frozenset`, :class:`list`,