gh-144706: Warn against using synchronization primitives within signal handlers ...

diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst
index d85d7138911016aeb8276a85c06eb340b1f5521d..c3fe9943ba9d760f59ba71c17c92542c8799808a 100644 (file)
--- a/Doc/library/signal.rst
+++ b/Doc/library/signal.rst
@@ -68,6 +68,11 @@ the synchronization primitives from the :mod:`threading` module instead.
 
 Besides, only the main thread of the main interpreter is allowed to set a new signal handler.
 
+.. warning::
+
+   Synchronization primitives such as :class:`threading.Lock` should not be used
+   within signal handlers.  Doing so can lead to unexpected deadlocks.
+
 
 Module contents
 ---------------