# HG changeset patch
# User Bruno Haible <bruno@clisp.org>
# Date 1272414924 -7200
# Node ID 2304ea7391699599ad8df3167b504afddc668ffd
# Parent  8e04f75cbbcaf69c84e24999c53146fe918e2b20
Update doc about utimes().

diff --git a/ChangeLog b/ChangeLog
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2010-04-27  Bruno Haible  <bruno@clisp.org>
+
+	Update doc about utimes().
+	* doc/posix-functions/utimes.texi: Mention the OSF/1 problem and the
+	'utimens' module.
+	Reported by Andreas Gruenbacher <agruen@suse.de>.
+
 2010-04-27  Eric Blake  <eblake@redhat.com>
 
 	full-read, full-write: relax license
diff --git a/doc/posix-functions/utimes.texi b/doc/posix-functions/utimes.texi
--- a/doc/posix-functions/utimes.texi
+++ b/doc/posix-functions/utimes.texi
@@ -16,6 +16,10 @@
 This function is missing on some platforms:
 mingw, Interix 3.5, BeOS.
 @item
+The declaration of this function lacks @code{const} in the second argument
+on some platforms:
+OSF/1 5.1.
+@item
 On some platforms, this function mis-handles trailing slash:
 FreeBSD 7.2, Solaris 9.
 @item
@@ -32,3 +36,7 @@
 @code{utime} worked fine.
 glibc 2.2.5.
 @end itemize
+
+Extension: Gnulib provides a module @samp{utimens} that works around these
+problems and allows to set the time with nanosecond resolution (as far as
+supported by the file system).