Add a(nother) warning about mixing Py_NewInterpreter and the

PyGILState_* functions.

diff --git a/Doc/api/init.tex b/Doc/api/init.tex
index 940aab9d0857ea1490810b1ebd33c57fba0838af..51b925f5bdd8af4bea19b33c47244a1894ed99c5 100644 (file)
--- a/Doc/api/init.tex
+++ b/Doc/api/init.tex
@@ -131,6 +131,12 @@
   objects may affect the wrong (sub-)interpreter's dictionary of
   loaded modules.  (XXX This is a hard-to-fix bug that will be
   addressed in a future release.)
+
+  Also note that the use of this functionality is incompatible with
+  extension modules such as PyObjC and ctypes that use the
+  \cfunction{PyGILState_*} APIs (and this is inherent in the way the
+  \cfunction{PyGILState_*} functions work).  Simple things may work,
+  but confusing behavior will always be near.
 \end{cfuncdesc}
 
 \begin{cfuncdesc}{void}{Py_EndInterpreter}{PyThreadState *tstate}