R. David Murray added the comment:

The existing documentation is technically correct, while your replacement 
leaves some things out, such as the fact that enumerate accepts an iteratable 
and returns an iterator that is specifically a special 'enumerate object'. (A 
sequence is an iteratable, but not all iterables sequences, and enumerate 
specifically does *not* return a list of pairs, and it is important to know 
that).

Can you explain what it is you find confusing about the existing documentation? 
 The examples should go a long way toward clarifying the text for those not 
familiar enough with the precisely correct terms it uses.

----------
nosy: +r.david.murray

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

Reply via email to