From: John Seong <39040639+sandole@users.noreply.github.com>
Date: Thu, 23 Apr 2026 02:46:04 +0000 (+0800)
Subject: gh-142965: Fix Concatenate documentation to reflect valid use cases (#143316)
X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=75ff1afcb6a1bb2b3d54899e9b222a61798fa491;p=thirdparty%2FPython%2Fcpython.git

gh-142965: Fix Concatenate documentation to reflect valid use cases (#143316)

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.
---

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 9bc0a3caeee8..04acf2c16d15 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -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 (``...``).