bpo-44926: get_type_hints: Add note about type aliases with forward…

… refs (#27859)
python · Aug 20, 2021 · 16b9be4 · 16b9be4
1 parent f5d7a8d
commit 16b9be4
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
@@ -2013,6 +2013,13 @@ Introspection helpers
            'name': Annotated[str, 'some marker']
        }
 
+   .. note::
+
+      :func:`get_type_hints` does not work with imported
+      :ref:`type aliases <type-aliases>` that include forward references.
+      Enabling postponed evaluation of annotations (:pep:`563`) may remove
+      the need for most forward references.
+
    .. versionchanged:: 3.9
       Added ``include_extras`` parameter as part of :pep:`593`.