From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 4 Apr 2021 15:36:21 +0000 (-0700)
Subject: [3.9] bpo-41370: Add note about ForwardRefs and PEP585 generic types in docs (GH... 
X-Git-Tag: v3.9.5~111
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d56bcf915b8d5a6afe4555cb6813c8210824e751;p=thirdparty%2FPython%2Fcpython.git

[3.9] bpo-41370: Add note about ForwardRefs and PEP585 generic types in docs (GH-25183) (GH-25184)



(cherry picked from commit 2b5913b4ee5852a28ca1509478f5582beb3aff7b)


Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>

Automerge-Triggered-By: GH:gvanrossum
---

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 688564f1d24f..b136da00a070 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -1710,10 +1710,15 @@ Introspection helpers
 .. class:: ForwardRef
 
    A class used for internal typing representation of string forward references.
-   For example, ``list["SomeClass"]`` is implicitly transformed into
-   ``list[ForwardRef("SomeClass")]``.  This class should not be instantiated by
+   For example, ``List["SomeClass"]`` is implicitly transformed into
+   ``List[ForwardRef("SomeClass")]``.  This class should not be instantiated by
    a user, but may be used by introspection tools.
 
+   .. note::
+      :pep:`585` generic types such as ``list["SomeClass"]`` will not be
+      implicitly transformed into ``list[ForwardRef("SomeClass")]`` and thus
+      will not automatically resolve to ``list[SomeClass]``.
+
    .. versionadded:: 3.7.4
 
 Constant