Message196976
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. |
|
Date |
User |
Action |
Args |
2013-09-05 03:48:15 | tim.peters | set | recipients:
+ tim.peters, pje, eli.bendersky, nikratio, docs@python |
2013-09-05 03:48:15 | tim.peters | set | messageid: <1378352895.7.0.507135141344.issue12704@psf.upfronthosting.co.za> |
2013-09-05 03:48:15 | tim.peters | link | issue12704 messages |
2013-09-05 03:48:15 | tim.peters | create | |
|