Gurmeet Singh added the comment: I am sorry to reopen this issue, if you do not like this comment, then I will reopen issues again.
I am not saying to change the convention of the documentation - I just requested you to say "something" that would indicate that it is function that gives result in multiple calls. Mentioning the "generator" or "iterator" word would help a "novice" (but may not an expert like you) to understand that the object returned by this function needs to be called repeatedly and it does not return a collection of all results. After reading "... would be better floated on python-list", I do not know if my posting this comment would be termed as bugging? ---------- status: closed -> open _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue17417> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com