Update asyncio.ensure_future() documentation (GH-15347) (GH-15364)
Added back mention that ensure_future actually scheduled obj. This documentation just mentions what ensure_future returns, so I did not realize that ensure_future also schedules obj.
(cherry picked from commit 092911d5c0d8f6db8a0cb02fecd73dbb650f9e2e)
Co-authored-by: Roger Iyengar <ri@rogeriyengar.com>
diff --git a/Doc/library/asyncio-future.rst b/Doc/library/asyncio-future.rst
index 6e6e013..c069471 100644
--- a/Doc/library/asyncio-future.rst
+++ b/Doc/library/asyncio-future.rst
@@ -35,7 +35,9 @@
is used for the test.)
* a :class:`Task` object wrapping *obj*, if *obj* is a
- coroutine (:func:`iscoroutine` is used for the test.)
+ coroutine (:func:`iscoroutine` is used for the test);
+ in this case the coroutine will be scheduled by
+ ``ensure_future()``.
* a :class:`Task` object that would await on *obj*, if *obj* is an
awaitable (:func:`inspect.isawaitable` is used for the test.)