From c6c921a4def19c9b44f1e1234b35f7fb0a609731 Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Mon, 26 Jan 1998 19:16:27 +0000
Subject: [PATCH] Py_AtExit():  Added brief note about the constraint on
 cleanup functions not 	      calling the Python API.

---
 Doc/api.tex     | 15 +++++++++------
 Doc/api/api.tex | 15 +++++++++------
 2 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/Doc/api.tex b/Doc/api.tex
index 4e1a8508d60..26fc104984f 100644
--- a/Doc/api.tex
+++ b/Doc/api.tex
@@ -542,12 +542,15 @@ calls the standard \C{} library function \code{exit(0)}.
 \end{cfuncdesc}
 
 \begin{cfuncdesc}{int}{Py_AtExit}{void (*func) ()}
-Register a cleanup function to be called by \code{Py_Finalize()}.  The
-cleanup function will be called with no arguments and should return no
-value.  At most 32 cleanup functions can be registered.  When the
-registration is successful, \code{Py_AtExit} returns 0; on failure, it
-returns -1.  The cleanup function registered last is called first.
-Each cleanup function will be called at most once.
+Register a cleanup function to be called by \cfunction{Py_Finalize()}.
+The cleanup function will be called with no arguments and should
+return no value.  At most 32 cleanup functions can be registered.
+When the registration is successful, \cfunction{Py_AtExit()} returns
+\code{0}; on failure, it returns \code{-1}.  The cleanup function
+registered last is called first.  Each cleanup function will be called
+at most once.  Since Python's internal finallization will have
+completed before the cleanup function, no Python APIs should be called
+by \var{func}.
 \end{cfuncdesc}
 
 
diff --git a/Doc/api/api.tex b/Doc/api/api.tex
index 4e1a8508d60..26fc104984f 100644
--- a/Doc/api/api.tex
+++ b/Doc/api/api.tex
@@ -542,12 +542,15 @@ calls the standard \C{} library function \code{exit(0)}.
 \end{cfuncdesc}
 
 \begin{cfuncdesc}{int}{Py_AtExit}{void (*func) ()}
-Register a cleanup function to be called by \code{Py_Finalize()}.  The
-cleanup function will be called with no arguments and should return no
-value.  At most 32 cleanup functions can be registered.  When the
-registration is successful, \code{Py_AtExit} returns 0; on failure, it
-returns -1.  The cleanup function registered last is called first.
-Each cleanup function will be called at most once.
+Register a cleanup function to be called by \cfunction{Py_Finalize()}.
+The cleanup function will be called with no arguments and should
+return no value.  At most 32 cleanup functions can be registered.
+When the registration is successful, \cfunction{Py_AtExit()} returns
+\code{0}; on failure, it returns \code{-1}.  The cleanup function
+registered last is called first.  Each cleanup function will be called
+at most once.  Since Python's internal finallization will have
+completed before the cleanup function, no Python APIs should be called
+by \var{func}.
 \end{cfuncdesc}