backport 1.17, 1.18 from the trunk: PyErr_SetInterrupt not Obsolete

(closes SF patch #919299)

diff --git a/Doc/api/exceptions.tex b/Doc/api/exceptions.tex
index f98b644896c219157fc97243f4fe69ce6aeeeeb1..5236a72c103d22dd5f2cefac9986cd7a67c10fe0 100644 (file)
--- a/Doc/api/exceptions.tex
+++ b/Doc/api/exceptions.tex
@@ -299,12 +299,14 @@ for each thread.
 \end{cfuncdesc}
 
 \begin{cfuncdesc}{void}{PyErr_SetInterrupt}{}
-  This function is obsolete.  It simulates the effect of a
+  This function simulates the effect of a
   \constant{SIGINT}\ttindex{SIGINT} signal arriving --- the next time
   \cfunction{PyErr_CheckSignals()} is called,
   \withsubitem{(built-in exception)}{\ttindex{KeyboardInterrupt}}
   \exception{KeyboardInterrupt} will be raised.  It may be called
   without holding the interpreter lock.
+  % XXX This was described as obsolete, but is used in
+  % thread.interrupt_main() (used from IDLE), so it's still needed.
 \end{cfuncdesc}
 
 \begin{cfuncdesc}{PyObject*}{PyErr_NewException}{char *name,