[Python-Dev] PEP 492: What is the real goal?

[Paul Moore]

On 30 April 2015 at 20:32, Guido van Rossum <guido at python.org> wrote:
>> Then I strongly request a more specific name than coroutine.
>
> No, this is the name we've been using since PEP 342 and it's still the same
> concept.

However, it is (as I noted in my other email) not very well
documented. There isn't a glossary entry in the docs for "coroutine",
and there's nothing pointing out that coroutines need (for anything
other than toy cases) an event loop, trampoline, or IO multiplexer
(call it what you want, although I prefer terms that don't make it
sound like it's exclusively about IO).

I'll raise an issue on the tracker for this, and I'll see if I can
write up something. Once there's a non-expert's view in the docs, the
experts can clarify the technicalities if I get them wrong :-) I
propose a section under
https://docs.python.org/3/reference/expressions.html#yield-expressions
describing coroutines, and their usage.

Paul