[docs] [issue12704] Language Reference: Clarify behaviour of yield when generator is not resumed

Tim Peters report at bugs.python.org
Thu Sep 5 05:48:15 CEST 2013

Tim Peters added the comment:

I think the docs are already clear:  they say "the generator-iterator’s close() method will be called".  That's all that needs to be said:  now go look at the docs for generator.close().  They explain _all_ that close() does, and it would be a Bad Idea to duplicate all that in this part of the docs too.  (And, yes, for a start, close() "Raises a GeneratorExit at the point where the generator function was paused".)

It would certainly help if the "close" (in "the generator-iterator’s close() method will be called") were an active hyperlink in the docs.

nosy: +tim.peters

Python tracker <report at bugs.python.org>

More information about the docs mailing list