From 17e6343d2d2c5d9279e30b7bd23215e5f6941a68 Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Thu, 31 Aug 2000 05:50:40 +0000 Subject: Document PyOS_CheckStack(). Fix a couple of really minor markup nits. --- Doc/api/api.tex | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/Doc/api/api.tex b/Doc/api/api.tex index fe09550..1f20129 100644 --- a/Doc/api/api.tex +++ b/Doc/api/api.tex @@ -850,7 +850,8 @@ or by code that needs to save and restore the error indicator temporarily. \end{cfuncdesc} -\begin{cfuncdesc}{void}{PyErr_Restore}{PyObject *type, PyObject *value, PyObject *traceback} +\begin{cfuncdesc}{void}{PyErr_Restore}{PyObject *type, PyObject *value, + PyObject *traceback} Set the error indicator from the three objects. If the error indicator is already set, it is cleared first. If the objects are \NULL{}, the error indicator is cleared. Do not pass a \NULL{} type @@ -858,7 +859,7 @@ and non-\NULL{} value or traceback. The exception type should be a string or class; if it is a class, the value should be an instance of that class. Do not pass an invalid exception type or value. (Violating these rules will cause subtle problems later.) This call -takes away a reference to each object, i.e. you must own a reference +takes away a reference to each object, i.e.\ you must own a reference to each object before the call and after the call you no longer own these references. (If you don't understand this, don't use this function. I warned you.) \strong{Note:} This function is normally @@ -1062,6 +1063,15 @@ continue to be used. If a new executable is loaded into the new process, this function does not need to be called. \end{cfuncdesc} +\begin{cfuncdesc}{int}{PyOS_CheckStack}{} +Return true when the interpreter runs out of stack space. This is a +reliable check, but is only available when \code{USE_STACKCHECK} is +defined (currently on Windows using the Microsoft Visual C++ compiler +and on the Macintosh). \code{USE_CHECKSTACK} will be defined +automatically; you should never change the definition in your own +code. +\end{cfuncdesc} + \section{Process Control \label{processControl}} -- cgit v0.12