Clarified warning about logging use from asynchronous signal handlers.

1 files changed, 4 insertions, 3 deletions

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 2a21d28b6e..b5553934c6 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -2351,9 +2351,10 @@ needing to be done by its clients. It achieves this though using threading
 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
 -------------