Gurmeet Singh added the comment:
I am sorry to reopen this issue, if you do not like this comment, then I will
reopen issues again.
I am not saying to change the convention of the documentation - I just
requested you to say something that would indicate that it is function that
gives result
Terry J. Reedy added the comment:
Reopening issues closed by a developer is worse than just 'bugging'. It wastes
time, distracts from real problems, and if repeated can get your tracker
account closed. Don't do it again.
I gave you a suggestion: post on python-list where you can get responses
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
New submission from Gurmeet Singh:
Source page: http://docs.python.org/3/library/os.html
Entry: os.walk(...), os.fwalk()
These functions seems to be a generator functions. An expert like yourself may
have no trouble to make this out. But for novice (or for people out of touch)
like myself
