bpo-25461: Update os.walk() docstring to match the online docs by codeape2 · Pull Request #11836 · python/cpython (original) (raw)

hmm sorry, but I don't notice an improve here. The idea is the same with different words.

Sometime docstring and docs differ on words.

But it would be great listen other opinions. :-)

This change has been discussed on bpo (https://bugs.python.org/issue25461#msg253377):

If you want to avoid ineffective because its meaning is subtle (a reasonable request), the correct replacement would be "modifying dirnames has no effect on the behavior of the walk", which is wordier but clearer.

The wording change in the online docs were done from a patch on that issue. For os.walk() the online docs and docstring were more or less equal, so it makes little sense to change the wording of one of them and not the other.

IIRC, the patch for os.py was added to the issue after the changes to os.rst had been merged.