Terry J. Reedy added the comment:

Our standard is to start function doc entries with verbs. In any case, it is 
irrelevant whether os.walk is a generator function or iterator class. Which is 
to say, it is not part of the language definition that the object returned by 
os.walk() is specifically a generator, as opposed to an instance of some other 
iterator class. Indeed, other implementations might do differently and if we 
decided to recode os.walk in C to make it faster, it would be an iterator class 
and not a generator function (which are only written in Python). So 'generate' 
is being used in a generic sense. 

Ideas like this, and the one about changing 'topdown', would be better floated 
on python-list.

----------
nosy: +terry.reedy
resolution:  -> works for me
stage:  -> committed/rejected
status: open -> closed

_______________________________________
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

Reply via email to