@@ -104,8 +104,10 @@ Note that calling it does not execute the function::
104104The terms "asynchronous function" (or "coroutine function") and "coroutine object"
105105are often conflated as coroutine.
106106That 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
110112That coroutine represents the function's body or logic.
111113A coroutine has to be explicitly started; again, merely creating the coroutine
@@ -426,7 +428,7 @@ and receiving control back when they pause or finish.
426428The ``watcher_task ``, which runs the coroutine: ``_sleep_watcher(...) `` will be
427429invoked once per full cycle of the event loop's queue.
428430On 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.
430432Eventually, enough time will have elapsed, and ``_sleep_watcher(...) `` will
431433mark the future as done, and then itself finish too by breaking out of the
432434infinite ``while `` loop.
0 commit comments