[New-bugs-announce] [issue24088] yield expression confusion

[Jim Jewett]

New submission from Jim Jewett:

https://docs.python.org/3/reference/expressions.html#yield-expressions

Current:
"""
When a generator function is called, it returns an iterator known as a generator. That generator then controls the execution of a generator function. The execution starts when one of the generator’s methods is called.
"""

At a minimum, that seems to be using "generator function" in two different ways, but I think there are other problems.

Proposed:
"""
When a generator function is called, it returns a special kind of iterator known as a generator. The iteration starts when one of the generator’s methods is called.
"""

----------
assignee: docs at python
components: Documentation, asyncio
messages: 242289
nosy: Jim.Jewett, docs at python, gvanrossum, haypo, yselivanov
priority: normal
severity: normal
status: open
title: yield expression confusion
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24088>
_______________________________________