From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sat, 13 Dec 2025 16:13:34 +0000 (+0100) Subject: [3.14] gh-142568: Fix eval() docs to use 'source' parameter name (GH-142644) (#142669) X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4e74259e91f8d4a56bb2d39d4475713ba05fdf43;p=thirdparty%2FPython%2Fcpython.git [3.14] gh-142568: Fix eval() docs to use 'source' parameter name (GH-142644) (#142669) gh-142568: Fix eval() docs to use 'source' parameter name (GH-142644) (cherry picked from commit c865ab3781e92ccc56b1729b2b751ac2769f50a0) Co-authored-by: Joshua Ward --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index c66486d3908a..3167ff4454fc 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -597,16 +597,16 @@ are always available. They are listed here in alphabetical order. This function executes arbitrary code. Calling it with user-supplied input may lead to security vulnerabilities. - The *expression* argument is parsed and evaluated as a Python expression + The *source* argument is parsed and evaluated as a Python expression (technically speaking, a condition list) using the *globals* and *locals* mappings as global and local namespace. If the *globals* dictionary is present and does not contain a value for the key ``__builtins__``, a reference to the dictionary of the built-in module :mod:`builtins` is - inserted under that key before *expression* is parsed. That way you can + inserted under that key before *source* is parsed. That way you can control what builtins are available to the executed code by inserting your own ``__builtins__`` dictionary into *globals* before passing it to :func:`eval`. If the *locals* mapping is omitted it defaults to the - *globals* dictionary. If both mappings are omitted, the expression is + *globals* dictionary. If both mappings are omitted, the source is executed with the *globals* and *locals* in the environment where :func:`eval` is called. Note, *eval()* will only have access to the :term:`nested scopes ` (non-locals) in the enclosing