The changes for the docs are just a port of the original patch.  And indeed, these functions don't return an iterator, but a generator object.

I admit I'm confused by the difference, since next() can be called directly on the generator.  Still, a lot of code in the test explicitly calls iter() on the iterators before doing next().  Not sure why.

The commented out line is an artifact, I'll remove it, the correct one is the test for 20 items.

Otherwise, I have no vested interest in getting this in.  My porting this is just me contributing to 2.7.  If it's vetoed, we'll just put it in 2.8.