Document typing.ForwardRef (GH-14216)

miss-islington · ilevkivskyi · web-flow · commit fff695b9abaa · 2019-06-18T17:38:43.000-07:00
(cherry picked from commit 809ff11) Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
@@ -1001,6 +1001,13 @@ The module defines the following classes, functions and decorators:
 
    .. versionadded:: 3.8
 
+.. 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
+   a user, but may be used by introspection tools.
+
 .. function:: NewType(typ)
 
    A helper function to indicate a distinct types to a typechecker,
