Author swanson
Recipients docs@python, swanson
Date 2015-07-17.06:53:38
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1437116019.06.0.685229534138.issue24650@psf.upfronthosting.co.za>
In-reply-to
Content
https://docs.python.org/3/reference/expressions.html

in
6.2.9. Yield expressions

end of 1st paragraph:

"Using a yield expression in a function’s body causes that function to be a generator."

NO!

As the very next sentence explains, a generator is what's returned by such a function, not the function itself.

Basically, it should be sufficient to add the word "function" to the end of that sentence: "... generator function."  However, this error does NOT exist in 3.0 to 3.2 - just in 3.3 to 3.6, so I suggest just using the same wording as 3.0 to 3.2:

"Using a yield expression in a function definition is sufficient to cause that definition to create a generator function instead of a normal function."
History
Date User Action Args
2015-07-17 06:53:39swansonsetrecipients: + swanson, docs@python
2015-07-17 06:53:39swansonsetmessageid: <1437116019.06.0.685229534138.issue24650@psf.upfronthosting.co.za>
2015-07-17 06:53:38swansonlinkissue24650 messages
2015-07-17 06:53:38swansoncreate