gh-79149: document reentrant safety of loop.call_soon_threadsafe (#128662)

kumaraditya303 · graingert · web-flow · commit 4685401845ba · 2025-01-09T09:19:05.000Z
Co-authored-by: Thomas Grainger &lt;tagrain@gmail.com&gt;
diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
@@ -246,6 +246,9 @@ Scheduling callbacks
    another thread, this function *must* be used, since :meth:`call_soon` is not
    thread-safe.
 
+   This function is safe to be called from a reentrant context or signal handler,
+   however, it is not safe or fruitful to use the returned handle in such contexts.
+
    Raises :exc:`RuntimeError` if called on a loop that's been closed.
    This can happen on a secondary thread when the main application is
    shutting down.
