gh-129368: In PyRun C API docs, clarify what a "start token" is (#129935)

This commit is contained in:
Rajhans Jadhao 2025-09-17 20:21:20 +05:30 committed by GitHub
parent 2629ee4eb0
commit e1eca8b308
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -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