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 <rep...@bugs.python.org>
<http://bugs.python.org/issue12704>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to