# HG changeset patch
# Parent e301ef50017889a4f8c864378d228e2f5ffee043
Issue #22875: Clarify the callback is only invoked after call_soon() returns

diff -r e301ef500178 Doc/library/asyncio-eventloop.rst
--- a/Doc/library/asyncio-eventloop.rst	Fri Dec 12 17:15:18 2014 -0800
+++ b/Doc/library/asyncio-eventloop.rst	Sat Dec 13 06:50:46 2014 +0000
@@ -85,7 +85,9 @@
 
 .. 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.