Message 325886 - Python tracker

➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author	Windson Yang
Recipients	Windson Yang, docs@python
Date	2018-09-20.15:22:10
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1537456930.09.0.956365154283.issue34753@psf.upfronthosting.co.za>
In-reply-to

Content
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.

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.

History
Date	User	Action	Args
2018-09-20 15:22:10	Windson Yang	set	recipients: + Windson Yang, docs@python
2018-09-20 15:22:10	Windson Yang	set	messageid: <1537456930.09.0.956365154283.issue34753@psf.upfronthosting.co.za>
2018-09-20 15:22:10	Windson Yang	link	issue34753 messages
2018-09-20 15:22:10	Windson Yang	create