https://github.com/python/cpython/commit/e1eca8b308a585af45e9ebf4f605c9f67b7115d8
commit: e1eca8b308a585af45e9ebf4f605c9f67b7115d8
branch: main
author: Rajhans Jadhao <[email protected]>
committer: erlend-aasland <[email protected]>
date: 2025-09-17T14:51:20Z
summary:
gh-129368: In PyRun C API docs, clarify what a "start token" is (#129935)
files:
M Doc/c-api/veryhigh.rst
diff --git a/Doc/c-api/veryhigh.rst b/Doc/c-api/veryhigh.rst
index fb07fec7effce8..ee0595a9e089c9 100644
--- a/Doc/c-api/veryhigh.rst
+++ b/Doc/c-api/veryhigh.rst
@@ -183,7 +183,8 @@ the same library that the Python runtime is using.
objects *globals* and *locals* with the compiler flags specified by
*flags*. *globals* must be a dictionary; *locals* can be any object
that implements the mapping protocol. The parameter *start* specifies
- the start token that should be used to parse the source code.
+ the start symbol and must one of the following:
+ :c:data:`Py_eval_input`, :c:data:`Py_file_input`, or
:c:data:`Py_single_input`.
Returns the result of executing the code as a Python object, or ``NULL`` if
an
exception was raised.
@@ -231,7 +232,7 @@ the same library that the Python runtime is using.
.. c:function:: PyObject* Py_CompileStringObject(const char *str, PyObject
*filename, int start, PyCompilerFlags *flags, int optimize)
Parse and compile the Python source code in *str*, returning the resulting
code
- object. The start token is given by *start*; this can be used to constrain
the
+ object. The start symbol is given by *start*; this can be used to
constrain the
code which can be compiled and should be :c:data:`Py_eval_input`,
:c:data:`Py_file_input`, or :c:data:`Py_single_input`. The filename
specified by
*filename* is used to construct the code object and may appear in
tracebacks or
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
