[issue10948] Trouble with dir_util created dir cache

Diego Queiroz report at bugs.python.org
Wed Jan 19 22:30:18 CET 2011

Diego Queiroz <queiroz.diego at gmail.com> added the comment:

You were right, "os.makedirs" fits my needs. :-)

Anyway, I still think the change in the documentation is needed.
This is not an implementation detail, it is part of the way the function works.

The user should be aware of the behavior when he call this function twice. In my opinion, the documentation should be clear about everything. We could call this an implementation detail iff it does not affect anything externally, but this is not the case (it affects subsequent calls).

This function does exactly the same of "os.makedirs" but the why is discribed only in a comment inside the code. We know this is a poor programming style. This information need to be available in the documentation too.


Python tracker <report at bugs.python.org>

More information about the Python-bugs-list mailing list