Document the new additional signature for utime(). In addition to the

previous functionality utime(path, (atime, mtime)), now allowed is
utime(path, None) which sets the file's times to the current time.

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 4001447f357fdc1ced997fe655f46eef2fa40a1e..0fb8f1018598ac21aa7bd4b523547769466de8c8 100644 (file)
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -702,9 +702,12 @@ Remove the file \var{path}.  This is the same function as
 Availability: Macintosh, \UNIX{}, Windows.
 \end{funcdesc}
 
-\begin{funcdesc}{utime}{path, (atime, mtime)}
-Set the access and modified time of the file to the given values.
-(The second argument is a tuple of two items.)
+\begin{funcdesc}{utime}{path, times}
+Set the access and modified times of the file specified by \var{path}.
+If \var{times} is \code{None}, then the file's access and modified
+times are set to the current time.  Otherwise, \var{times} must be a
+2-tuple of numbers, of the form \var{(atime, mtime)} which is used to
+set the access and modified times, respectively.
 Availability: Macintosh, \UNIX{}, Windows.
 \end{funcdesc}