From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sat, 13 Dec 2025 16:15:21 +0000 (+0100) Subject: [3.13] gh-142568: Fix eval() docs to use 'source' parameter name (GH-142644) (#142670) X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2b7b485c8d9385b91d15a93b8b7ef72ee7a95e0b;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-142568: Fix eval() docs to use 'source' parameter name (GH-142644) (#142670) 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 04b5dc5bf820..d9ec50acf220 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -591,16 +591,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