Bugs item #1625509, was opened at 2006-12-31 18:22
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1625509&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: Python 2.5
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Dustin J. Mitchell (djmitche)
Assigned to: Nobody/Anonymous (nobody)
Summary: 'imp' documentation does not mention that lock is re-entrant

Initial Comment:
My reading of import.c shows that imp.{acquire,release}_lock operate in the 
fashion of a threading.RLock, rather than a threading.Lock.  Of course, this 
makes sense for the use to which it's put, but it would be great to have that 
mentioned explicitly in the documentation.  Suggestion (stolen from threading 
documentation):

acquire_lock()
Acquires the interpreter's import lock for the current thread. This lock should 
be used by import hooks to ensure thread-safety when importing modules. 

Once a thread has acquired the import lock, the same thread may acquire it 
again without blocking; the thread must release it once for each time it has 
acquired it.

On platforms without threads, this function does nothing. New in version 2.3.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1625509&group_id=5470
_______________________________________________
Python-bugs-list mailing list 
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to