asyncio doc: call_soon() does not call immediatly the callback. Patch written

by Martin Panter.

diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
index d6c2e30df441b786f5a75b30e396a90f10da8cdf..748d4e3fc400c8999168fa5bb5a1f89453e77af1 100644 (file)
--- a/Doc/library/asyncio-eventloop.rst
+++ b/Doc/library/asyncio-eventloop.rst
@@ -85,7 +85,9 @@ keywords to your callback, use :func:`functools.partial`. For example,
 
 .. method:: BaseEventLoop.call_soon(callback, \*args)
 
-   Arrange for a callback to be called as soon as possible.
+   Arrange for a callback to be called as soon as possible.  The callback is
+   called after :meth:`call_soon` returns, when control returns to the event
+   loop.
 
    This operates as a FIFO queue, callbacks are called in the order in
    which they are registered.  Each callback will be called exactly once.