Skip to content

Commit a730bd3

Browse files
committed
nits
1 parent 6756257 commit a730bd3

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

Doc/howto/a-conceptual-overview-of-asyncio.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -104,8 +104,10 @@ Note that calling it does not execute the function::
104104
The terms "asynchronous function" (or "coroutine function") and "coroutine object"
105105
are often conflated as coroutine.
106106
That can be confusing!
107-
In this article, coroutine will exclusively mean "coroutine object" -- the
108-
thing produced by executing a coroutine function.
107+
In this article, coroutine specifically refers to a coroutine object, or more
108+
precisely, an instance of :data:`types.CoroutineType` (native coroutine).
109+
Note that coroutines can also exist as instances of :class:`collections.abc.Coroutine`
110+
-- a distinction that matters for type checking.
109111

110112
That coroutine represents the function's body or logic.
111113
A coroutine has to be explicitly started; again, merely creating the coroutine
@@ -426,7 +428,7 @@ and receiving control back when they pause or finish.
426428
The ``watcher_task``, which runs the coroutine: ``_sleep_watcher(...)`` will be
427429
invoked once per full cycle of the event loop's queue.
428430
On each resumption, it'll check the time and if not enough has elapsed, then it'll
429-
pause once again and return control to the event loop.
431+
pause once again and hand control back to the event loop.
430432
Eventually, enough time will have elapsed, and ``_sleep_watcher(...)`` will
431433
mark the future as done, and then itself finish too by breaking out of the
432434
infinite ``while`` loop.

0 commit comments

Comments
 (0)