]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.14] gh-142965: Fix Concatenate documentation to reflect valid use cases (GH-143316...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Thu, 23 Apr 2026 02:57:54 +0000 (04:57 +0200)
committerGitHub <noreply@github.com>
Thu, 23 Apr 2026 02:57:54 +0000 (19:57 -0700)
The documentation previously stated that Concatenate is only valid
when used as the first argument to Callable, but according to PEP 612,
it can also be used when instantiating user-defined generic classes
with ParamSpec parameters.
(cherry picked from commit 75ff1afcb6a1bb2b3d54899e9b222a61798fa491)

Co-authored-by: John Seong <39040639+sandole@users.noreply.github.com>
Doc/library/typing.rst

index a2625ab2a371663c40a6c3e475ff54c4656b0f99..40f8c130d801db036eb71aa914123ba847b7b01b 100644 (file)
@@ -1174,7 +1174,8 @@ These can be used as types in annotations. They all support subscription using
    or transforms parameters of another
    callable.  Usage is in the form
    ``Concatenate[Arg1Type, Arg2Type, ..., ParamSpecVariable]``. ``Concatenate``
-   is currently only valid when used as the first argument to a :ref:`Callable <annotating-callables>`.
+   is valid when used in :ref:`Callable <annotating-callables>` type hints
+   and when instantiating user-defined generic classes with :class:`ParamSpec` parameters.
    The last parameter to ``Concatenate`` must be a :class:`ParamSpec` or
    ellipsis (``...``).