[New-bugs-announce] [issue25461] Unclear language (the word ineffective) in the documentation for os.walk

Bernt Røskar Brenna report at bugs.python.org
Thu Oct 22 13:05:38 EDT 2015


New submission from Bernt Røskar Brenna:

At least for me (non-english speaker), the following is confusing:

"Modifying dirnames when topdown is False is ineffective, because in bottom-up mode the directories in dirnames are generated before dirpath itself is generated."

I suggest to replace "is ineffective" with "has no effect".

Ineffective could also mean: "Has low performance", could it not?

----------
assignee: docs at python
components: Documentation
messages: 253338
nosy: Bernt.Røskar.Brenna, docs at python
priority: normal
severity: normal
status: open
title: Unclear language (the word ineffective) in the documentation for os.walk
type: enhancement
versions: Python 2.7, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue25461>
_______________________________________


More information about the New-bugs-announce mailing list