mirror of
https://github.com/python/cpython.git
synced 2025-07-07 19:35:27 +00:00
f4bc3a9320
Document behaviour of single-phase init. Call it "legacy". Reorganize PyModule docs. Move PyInit_modulename docs from the tutorial to reference documentation. Move PyMODINIT_FUNC docs from generic macros to the new page. Add doc stubs for `PYTHON_API_VERSION` & `PYTHON_ABI_VERSION` Remove incorrect refcounts.dat entry for `PyModuleDef_Init`. This removes the "Return value: Borrowed reference." note. Instead, note that the function sometimes returns a borrowed reference, sometimes as strong one. (IMO, it's best to not think of `PyModuleDef` as a `PyObject` at all, and act like it can't be reference-counted.) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
29 lines
675 B
ReStructuredText
29 lines
675 B
ReStructuredText
.. _c-api-index:
|
|
|
|
##################################
|
|
Python/C API Reference Manual
|
|
##################################
|
|
|
|
This manual documents the API used by C and C++ programmers who want to write
|
|
extension modules or embed Python. It is a companion to :ref:`extending-index`,
|
|
which describes the general principles of extension writing but does not
|
|
document the API functions in detail.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
intro.rst
|
|
stable.rst
|
|
veryhigh.rst
|
|
refcounting.rst
|
|
exceptions.rst
|
|
extension-modules.rst
|
|
utilities.rst
|
|
abstract.rst
|
|
concrete.rst
|
|
init.rst
|
|
init_config.rst
|
|
memory.rst
|
|
objimpl.rst
|
|
apiabiversion.rst
|
|
monitoring.rst
|