[issue17416] Clarify docs of os.walk()

2013-03-17 Thread Terry J. Reedy
Terry J. Reedy added the comment: I considered your point, re-read the walk entry, and still wish to leave it as it is. First, we are not in the business of providing synonyms for everything. Second, The abbreviations BFS and DFS did not immediately register with me, even though I am quite fam

[issue17416] Clarify docs of os.walk()

2013-03-16 Thread Gurmeet Singh
Gurmeet Singh added the comment: Hi Terry, I understand it is ok for you. I agree that you are not in favour of changing the argument name. And you are correct that I must get familiar to the convention that has been used. Further since you say, perhaps, I now feel that it may be used in ot

[issue17416] Clarify docs of os.walk()

2013-03-15 Thread Terry J. Reedy
Terry J. Reedy added the comment: The unambiguous title of your first report was better, so I copied it with a new method name. Changing a parameter name will break code, so it is essentially never done. In any case, directory trees are considered to grow 'down' from the root directory, and t