This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author jgehrcke
Recipients docs@python, jgehrcke
Date 2014-02-20.22:57:35
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <>
The os.utime() docs for Python 2 ( and 3 ( both contain the sentence

"Whether a directory can be given for path depends on whether the operating system implements directories as files (for example, *Windows does not*)"

"Windoes does not" is wrong. CPython 2.7 on Windows 7:

>>> os.utime(".", (100, 100))
>>> os.stat(".").st_mtime

We should
- either name a specific system for which this does not work
- or remove this example.

Windows XP and newer support this operation via SetFileTime ( "Sets the date and time that the specified file or directory was created, last accessed, or last modified."

I have grepped myself through a couple of CPython source trees and found

posixmodule.c:        if (!SetFileTime(hFile, NULL, &atime, &mtime)

in 2.5, 2.6, 2.7. I guess the statement comes from 2.4 times, where `SetFileTime` only appears in `PC/bdist_wininst/extract.c`.

So, do we just remove the hint or does someone have an example at hand for which combination of Python and platform this does not work for directories? Once we have a decision, I will be happy to provide the mini patch.
Date User Action Args
2014-02-20 22:57:36jgehrckesetrecipients: + jgehrcke, docs@python
2014-02-20 22:57:36jgehrckesetmessageid: <>
2014-02-20 22:57:35jgehrckelinkissue20709 messages
2014-02-20 22:57:35jgehrckecreate