[3.9] bpo-38870: Extend subject of ast.unparse warnings (GH-21053) (GH-21191)

pablogsal · web-flow · commit 6e39999a246a · 2020-06-28T02:22:30.000+01:00
- Mention that some compiler optimizations might not roundtrip exactly (such as constant tuples and frozensets). - Add a warning about it might raise RecursionError on very complex expressions due to the recursive unparsing aspect of ast.unparse (cherry picked from commit 8df1016)
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
@@ -1553,7 +1553,12 @@ and classes for traversing abstract syntax trees:
 
    .. warning::
       The produced code string will not necessarily be equal to the original
-      code that generated the :class:`ast.AST` object.
+      code that generated the :class:`ast.AST` object (without any compiler
+      optimizations, such as constant tuples/frozensets).
+
+   .. warning::
+      Trying to unparse a highly complex expression would result with
+      :exc:`RecursionError`.
 
    .. versionadded:: 3.9
 
