asyncio doc: more explicit doc for async()

vstinner · vstinner · commit 980dd84f92f6 · 2014-10-12T21:36:17.000+02:00
The function schedules the execution of coroutines, it's not just a wrapper for
something.
diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
@@ -478,7 +478,8 @@ Task functions
 
 .. function:: async(coro_or_future, \*, loop=None)
 
-   Wrap a :ref:`coroutine object <coroutine>` in a future.
+   Schedule the execution of a :ref:`coroutine object <coroutine>`: wrap it in
+   a future. Return a :class:`Task` object.
 
    If the argument is a :class:`Future`, it is returned directly.
 
