Commit 5b02ef3e authored by Benjamin Peterson's avatar Benjamin Peterson

note how os.utime should be used for emulating touch

parent 4eb99393
......@@ -1303,15 +1303,16 @@ Files and Directories
.. function:: utime(path, times)
Set the access and modified times of the file specified by *path*. If *times* is
``None``, then the file's access and modified times are set to the current time.
Otherwise, *times* must be a 2-tuple of numbers, of the form ``(atime, mtime)``
which is used to set the access and modified times, respectively. Whether a
directory can be given for *path* depends on whether the operating system
implements directories as files (for example, Windows does not). Note that the
exact times you set here may not be returned by a subsequent :func:`stat` call,
depending on the resolution with which your operating system records access and
modification times; see :func:`stat`.
Set the access and modified times of the file specified by *path*. If *times*
is ``None``, then the file's access and modified times are set to the current
time. (The effect is similar to running the Unix program :program:`touch` on
the path.) Otherwise, *times* must be a 2-tuple of numbers, of the form
``(atime, mtime)`` which is used to set the access and modified times,
respectively. Whether a directory can be given for *path* depends on whether
the operating system implements directories as files (for example, Windows
does not). Note that the exact times you set here may not be returned by a
subsequent :func:`stat` call, depending on the resolution with which your
operating system records access and modification times; see :func:`stat`.
.. versionchanged:: 2.0
Added support for ``None`` for *times*.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment