Undocumented 3.13 C API

[encukou]

The following public C API is new in 3.13 (beta 1, relative to 3.12), and as of this writing it looks either

• undocumented, or
• documented incorrectly. See the docs search page for what Sphinx thinks the type and fully-quilfied name of the symbol are; it should be a C entry without extraneous namespaces. (The details tend to matter for search, URLs, and Intersphinx links.)

\

• PY_MACCONFIG_H in Include/pymacconfig.h (header guards don't need docs)
• PY_MONITORING_EVENT_BRANCH in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_CALL in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_C_RAISE in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_C_RETURN in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_EXCEPTION_HANDLED in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_INSTRUCTION in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_JUMP in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_LINE in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_PY_RESUME in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_PY_RETURN in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_PY_START in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_PY_THROW in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_PY_UNWIND in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_PY_YIELD in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_RAISE in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_RERAISE in Include/cpython/monitoring.h
• PY_MONITORING_EVENT_STOP_ITERATION in Include/cpython/monitoring.h
• PY_MONITORING_IS_INSTRUMENTED_EVENT in Include/cpython/monitoring.h
• PyCF_OPTIMIZED_AST in Include/cpython/compile.h
• PyEval_GetFrameBuiltins in Include/ceval.h:25
• PyEval_GetFrameGlobals in Include/ceval.h:26
• PyEval_GetFrameLocals in Include/ceval.h:27
• PyExc_IncompleteInputError in Include/pyerrors.h:111
• PyExc_PythonFinalizationError in Include/cpython/pyerrors.h:129
• PyFrameLocalsProxy_Check in Include/cpython/pyframe.h
• PyFrameLocalsProxy_Type in Include/cpython/pyframe.h:6
• PyMonitoring_EnterScope in Include/cpython/monitoring.h:44
• PyMonitoring_ExitScope in Include/cpython/monitoring.h:48
• PyRefTracerEvent in Include/cpython/object.h:516, Include/cpython/object.h:519
• PyUnstable_AtExit in Include/cpython/pylifecycle.h:91
• PyUnstable_CopyPerfMapFile in Include/cpython/sysmodule.h:20
• PyUnstable_EXECUTABLE_KINDS in Include/cpython/pyframe.h
• PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION in Include/cpython/pyframe.h
• PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR in Include/cpython/pyframe.h
• PyUnstable_EXECUTABLE_KIND_PY_FUNCTION in Include/cpython/pyframe.h
• PyUnstable_EXECUTABLE_KIND_SKIP in Include/cpython/pyframe.h
• PyUnstable_ExecutableKinds in Include/cpython/pyframe.h:45
• PyUnstable_GetExecutor in Include/cpython/optimizer.h:137
• PyUnstable_GetOptimizer in Include/cpython/optimizer.h:135
• PyUnstable_InterpreterState_GetMainModule in Include/cpython/pystate.h:11
• PyUnstable_Optimizer_NewCounter in Include/cpython/optimizer.h:145
• PyUnstable_Optimizer_NewUOpOptimizer in Include/cpython/optimizer.h:146
• PyUnstable_PerfTrampoline_CompileCode in Include/cpython/sysmodule.h:21
• PyUnstable_PerfTrampoline_SetPersistAfterFork in Include/cpython/sysmodule.h:22
• PyUnstable_Replace_Executor in Include/cpython/optimizer.h:129
• PyUnstable_SetOptimizer in Include/cpython/optimizer.h:133
• Py_ASNATIVEBYTES_BIG_ENDIAN in Include/cpython/longobject.h
• Py_ASNATIVEBYTES_DEFAULTS in Include/cpython/longobject.h
• Py_ASNATIVEBYTES_LITTLE_ENDIAN in Include/cpython/longobject.h
• Py_ASNATIVEBYTES_NATIVE_ENDIAN in Include/cpython/longobject.h
• Py_ASNATIVEBYTES_REJECT_NEGATIVE in Include/cpython/longobject.h
• Py_ASNATIVEBYTES_UNSIGNED_BUFFER in Include/cpython/longobject.h
• Py_ATOMIC_H in Include/pyatomic.h (header guards don't need docs)
• Py_CAN_START_THREADS in Include/pyport.h:463
• Py_C_RECURSION_LIMIT in Include/cpython/pystate.h:215
• Py_MOD_GIL_NOT_USED in Include/moduleobject.h:69
• Py_MOD_GIL_USED in Include/moduleobject.h:69
• Py_MONITORING_H in Include/monitoring.h (header guards don't need docs)
• Py_OPTIMIZER_H in Include/cpython/optimizer.h (header guards don't need docs)
• Py_TPFLAGS_INLINE_VALUES in Include/object.h:632
• Py_TRASHCAN_HEADROOM in Include/cpython/object.h:463

(I've excluded stuff from #118771.)

[ronaldoussoren]

PY_MACCONFIG_H was almost certainly introduced by me, and almost matches the pattern used in other headers (other headers use Py_ as the prefix and not PY_. Its just there to make it safe to include the header more than once and does not have to be documented.