New submission from Windson Yang <wiwind...@gmail.com>:

A PR https://github.com/python/cpython/pull/9408 solved an ambiguous problem 
about coroutine. Which led me to 
https://docs.python.org/3/library/asyncio-task.html#awaitables

> Note that in this documentation the term “coroutine” can be used for two 
> closely related concepts:

> a coroutine function: an async def function;
> a coroutine object: object returned by calling a coroutine function.

This will let people confused. IMO we should use `coroutine object` or 
`coroutine function` instead of coroutine when it means an object. For 
instance, L22 in 
https://github.com/python/cpython/blob/471503954a91d86cf04228c38134108c67a263b0/Doc/library/asyncio-api-index.rst

> Create event loop, run a coroutine, close the loop.
should be
> Create event loop, run a coroutine object, close the loop.

----------
assignee: docs@python
components: Documentation
messages: 325886
nosy: Windson Yang, docs@python
priority: normal
severity: normal
status: open
title: Use coroutine object or coroutine function instead of coroutine
type: enhancement
versions: Python 3.8

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue34753>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to