From: Brett Cannon <brettcannon@users.noreply.github.com>
Date: Fri, 9 Mar 2018 21:13:32 +0000 (-0800)
Subject: Warn that compile() can crash when compiling to an AST object (GH-6043)
X-Git-Tag: v3.8.0a1~2114
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f7a6ff6fcab32a53f262ba3f8a072c27afc330d7;p=thirdparty%2FPython%2Fcpython.git

Warn that compile() can crash when compiling to an AST object (GH-6043)
---

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index bfb813cf3906..3ddd280f77eb 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -274,6 +274,12 @@ are always available.  They are listed here in alphabetical order.
       character.  This is to facilitate detection of incomplete and complete
       statements in the :mod:`code` module.
 
+   .. warning::
+
+      It is possible to crash the Python interpreter with a
+      sufficiently large/complex string when compiling to an AST
+      object due to stack depth limitations in Python's AST compiler.
+
    .. versionchanged:: 3.2
       Allowed use of Windows and Mac newlines.  Also input in ``'exec'`` mode
       does not have to end in a newline anymore.  Added the *optimize* parameter.