Josh Rosenberg added the comment:

Aside from the method being named __next__(), it's the same flaw in all copies 
of the Py3 documentation.

I don't think explicitly enumerating types is the way to go though. I'd just 
remove the documentation for __next__, and leave it up to the per-type 
documentation to describe the data structure returned when iterating. None of 
the other built-in types in Py3 bother to explicitly document "internal" 
methods like __next__, but rather describe iteration while describing the type 
itself.

----------
nosy: +josh.rosenberg

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue21056>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to