]> granicus.if.org Git - python/commitdiff
Document PyOS_CheckStack().
authorFred Drake <fdrake@acm.org>
Thu, 31 Aug 2000 05:50:40 +0000 (05:50 +0000)
committerFred Drake <fdrake@acm.org>
Thu, 31 Aug 2000 05:50:40 +0000 (05:50 +0000)
Fix a couple of really minor markup nits.

Doc/api/api.tex

index fe095500b83190fbbaf25fb5da42017af3be919a..1f20129e2563ec812011f0bf341e795784f0349e 100644 (file)
@@ -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}}