[Python-checkins] CVS: python/dist/src/Doc/lib libimp.tex,1.29,1.30

[Tim Peters]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv23325/Doc/lib

Modified Files:
	libimp.tex 
Log Message:
Add a new function imp.lock_held(), and use it to skip test_threaded_import
when that test is doomed to deadlock.


Index: libimp.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libimp.tex,v
retrieving revision 1.29
retrieving revision 1.30
diff -C2 -d -r1.29 -r1.30
*** libimp.tex	2001/07/06 19:28:48	1.29
--- libimp.tex	2001/08/30 05:16:12	1.30
***************
*** 94,97 ****
--- 94,110 ----
  \end{funcdesc}
  
+ \begin{funcdesc}{lock_held}{}
+ Return 1 if the import lock is currently held, else 0.
+ On platforms without threads, always return 0.
+ 
+ On platforms with threads, a thread executing an import holds an internal
+ lock until the import is complete.
+ This lock blocks other threads from doing an import until the original
+ import completes, which in turn prevents other threads from seeing
+ incomplete module objects constructed by the original thread while in
+ the process of completing its import (and the imports, if any,
+ triggered by that).
+ \end{funcdesc}
+ 
  The following constants with integer values, defined in this module,
  are used to indicate the search result of \function{find_module()}.