diff --git a/Doc/api/api.tex b/Doc/api/api.tex index 3f3b65f2bcf..e38e0b550f3 100644 --- a/Doc/api/api.tex +++ b/Doc/api/api.tex @@ -4650,7 +4650,37 @@ implementing new object types in C. \begin{cfuncdesc}{void}{PyObject_DEL}{PyObject *op} \end{cfuncdesc} -Py_InitModule (!!!) +\begin{cfuncdesc}{PyObject*}{Py_InitModule}{char *name, + PyMethodDef *methods} + Create a new module object based on a name and table of functions, + returning the new module object. +\end{cfuncdesc} + +\begin{cfuncdesc}{PyObject*}{Py_InitModule3}{char *name, + PyMethodDef *methods, + char *doc} + Create a new module object based on a name and table of functions, + returning the new module object. If \var{doc} is non-\NULL, it will + be used to define the docstring for the module. +\end{cfuncdesc} + +\begin{cfuncdesc}{PyObject*}{Py_InitModule4}{char *name, + PyMethodDef *methods, + char *doc, PyObject *self, + int apiver} + Create a new module object based on a name and table of functions, + returning the new module object. If \var{doc} is non-\NULL, it will + be used to define the docstring for the module. If \var{self} is + non-\NULL, it will passed to the functions of the module as their + (otherwise \NULL) first parameter. (This was added as an + experimental feature, and there are no known uses in the current + version of Python.) For \var{apiver}, the only value which should + be passed is defined by the constant \constant{PYTHON_API_VERSION}. + + \strong{Note:} Most uses of this function should probably be using + the \cfunction{Py_InitModule3()} instead; only use this if you are + sure you need it. +\end{cfuncdesc} PyArg_ParseTupleAndKeywords, PyArg_ParseTuple, PyArg_Parse diff --git a/Doc/api/refcounts.dat b/Doc/api/refcounts.dat index 8021151de79..aace6950bb6 100644 --- a/Doc/api/refcounts.dat +++ b/Doc/api/refcounts.dat @@ -274,6 +274,22 @@ PyFloat_Check:PyObject*:p:0: PyFloat_FromDouble:PyObject*::+1: PyFloat_FromDouble:double:v:: +Py_InitModule:PyObject*::0: +Py_InitModule:name:char*:: +Py_InitModule:methods:PyMethodDef[]:: + +Py_InitModule3:PyObject*::0: +Py_InitModule3:name:char*:: +Py_InitModule3:methods:PyMethodDef[]:: +Py_InitModule3:doc:char*:: + +Py_InitModule4:PyObject*::0: +Py_InitModule4:name:char*:: +Py_InitModule4:methods:PyMethodDef[]:: +Py_InitModule4:doc:char*:: +Py_InitModule4:self:PyObject*:: +Py_InitModule4:apiver:int::usually provided by Py_InitModule or Py_InitModule3 + PyImport_AddModule:PyObject*::0:reference borrowed from sys.modules PyImport_AddModule:char*:name::