[Python-checkins] r71106 - python/trunk/Doc/library/logging.rst

[vinay.sajip]

Author: vinay.sajip
Date: Fri Apr  3 23:58:16 2009
New Revision: 71106

Log:
Clarified warning about logging use from asynchronous signal handlers.

Modified:
   python/trunk/Doc/library/logging.rst

Modified: python/trunk/Doc/library/logging.rst
==============================================================================
--- python/trunk/Doc/library/logging.rst	(original)
+++ python/trunk/Doc/library/logging.rst	Fri Apr  3 23:58:16 2009
@@ -2351,9 +2351,10 @@
 locks; there is one lock to serialize access to the module's shared data, and
 each handler also creates a lock to serialize access to its underlying I/O.
 
-Note that in Linux/Unix environments, threading APIs  may not be usable in
-asynchronous signal handlers. This may mean that you cannot use logging from
-within asynchronous signal handlers; please check your OS documentation.
+If you are implementing asynchronous signal handlers using the :mod:`signal`
+module, you may not be able to use logging from within such handlers. This is
+because lock implementations in the :mod:`threading` module are not always
+re-entrant, and so cannot be invoked from such signal handlers.
 
 Configuration
 -------------