From fa0e763813f3d578b900c49f9d81a1f9267722da Mon Sep 17 00:00:00 2001 From: Rafael Fontenelle Date: Wed, 30 Apr 2025 13:52:03 -0300 Subject: [PATCH] Apply 'mod' role to typing module (GH-133201) (cherry picked from commit 2b67db7ce3d73c9ad905125f9a602657afe9be9f) Co-authored-by: Rafael Fontenelle Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- Doc/library/typing.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index bba7114fc1ff33..ee51f81846e9b3 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -665,7 +665,7 @@ through a simple assignment:: User-defined generics for parameter expressions are also supported via parameter specification variables in the form ``[**P]``. The behavior is consistent with type variables' described above as parameter specification variables are -treated by the typing module as a specialized type variable. The one exception +treated by the :mod:`!typing` module as a specialized type variable. The one exception to this is that a list of types can be used to substitute a :class:`ParamSpec`:: >>> class Z[T, **P]: ... # T is a TypeVar; P is a ParamSpec @@ -706,7 +706,7 @@ are intended primarily for static type checking. A user-defined generic class can have ABCs as base classes without a metaclass conflict. Generic metaclasses are not supported. The outcome of parameterizing -generics is cached, and most types in the typing module are :term:`hashable` and +generics is cached, and most types in the :mod:`!typing` module are :term:`hashable` and comparable for equality. @@ -2685,7 +2685,7 @@ types. Protocols --------- -The following protocols are provided by the typing module. All are decorated +The following protocols are provided by the :mod:`!typing` module. All are decorated with :func:`@runtime_checkable `. .. class:: SupportsAbs @@ -3384,7 +3384,7 @@ Deprecated aliases ------------------ This module defines several deprecated aliases to pre-existing -standard library classes. These were originally included in the typing +standard library classes. These were originally included in the :mod:`!typing` module in order to support parameterizing these generic classes using ``[]``. However, the aliases became redundant in Python 3.9 when the corresponding pre-existing classes were enhanced to support ``[]`` (see @@ -3397,7 +3397,7 @@ interpreter for these aliases. If at some point it is decided to remove these deprecated aliases, a deprecation warning will be issued by the interpreter for at least two releases -prior to removal. The aliases are guaranteed to remain in the typing module +prior to removal. The aliases are guaranteed to remain in the :mod:`!typing` module without deprecation warnings until at least Python 3.14. Type checkers are encouraged to flag uses of the deprecated types if the