bpo-39159: Declare error that might be raised from literal_eval (GH-19899)
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 8a5c6ec..9149a53 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -1576,7 +1576,7 @@
Safely evaluate an expression node or a string containing a Python literal or
container display. The string or node provided may only consist of the
following Python literal structures: strings, bytes, numbers, tuples, lists,
- dicts, sets, booleans, and ``None``.
+ dicts, sets, booleans, ``None`` and ``Ellipsis``.
This can be used for safely evaluating strings containing Python values from
untrusted sources without the need to parse the values oneself. It is not
@@ -1588,6 +1588,10 @@
sufficiently large/complex string due to stack depth limitations
in Python's AST compiler.
+ It can raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`,
+ :exc:`MemoryError` and :exc:`RecursionError` depending on the malformed
+ input.
+
.. versionchanged:: 3.2
Now allows bytes and set literals.