https://docs.python.org/3/reference/datamodel#object.__iter__

> This method should return a new iterator object that can iterate over all the objects
> in the container. For mappings, it should iterate over the keys of the container, and
> should also be made available as the method keys().

In 3.x, d.__iter__() is not equivalent to d.keys() but to iter(d.keys()).

They aren't equivalent in python2, either.  I think probably the wording should be changed to something like "and the method keys() should return an iterable that provides access to the same data".

The Python 2 doc is alright, the same line says that d.__iter__() is equivalent to d.iterkeys().

Ah, I see.  So the python3 docs should say "and should be equivalent to iter(dict.keys())" ?  Or maybe the whole phrase should just be dropped.

I think the first half of the sentence is enough: “For mappings, it should iterate over the keys of the container.”

Since .iterkeys is gone, I thing the ', and' part should just be dropped.

> I think the first half of the sentence is enough: 
> “For mappings, it should iterate over the keys of the container.”

That should do it :-)

New changeset 743ebaba14db by R David Murray in branch '3.4':
#22918: Drop obsolete mention of 'keys' in datamodel __iter__ docs.
https://hg.python.org/cpython/rev/743ebaba14db

New changeset 1a1f577ca647 by R David Murray in branch 'default':
Merge: #22918: Drop obsolete mention of 'keys' in datamodel __iter__ docs.
https://hg.python.org/cpython/rev/1a1f577ca647

Thanks, Chaitanya.