tags 431480 fixed-upstream thanks Hello Vincent,
The changes described below will be in upstream 2.65. > 1. The utimes(2) man page mentions: > > int utime(const char *filename, const struct utimbuf *buf); > int utimes(const char *filename, const struct timeval times[2]); > > and describes the case where buf is a null pointer, but not the case > where times is a null pointer, though this is allowed by POSIX: > > http://www.opengroup.org/onlinepubs/009695399/functions/utimes.html The existing text kind of implies the behaviour: The function utimes() is similar, .... but I agree, that the point could be clearer. I've updated this part of the page to say: utimes() The function utimes() is similar, but allows a resolution of 1 microsecond. The timeval structure is: struct timeval { long tv_sec; /* seconds */ long tv_usec; /* microseconds */ }; times[0] specifies the new access time, and times[1] specifies the new modification time. If times is NULL, then analogously to utime(), the access and modification times of the file are set to the current time. > 2. In the 3rd paragraph of the description, replace "buf must is" by > "buf is". Thanks. > 3. You should say "a null pointer" instead of "NULL" ("NULL" isn't > necessarily a pointer and is a C notion, and both the C standard and > POSIX use the term "a null pointer"). The copy of POSIX.1-2001 I am looking at is littered with the use of terms like: NULL NULL pointer non-NULL a NULL pointer non-NULL value if ... is [not] NULL and so on. So one of us is confused by your last point; at the moment, I think it is you ;-). (I don't disagree that "NULL" is a "C construct", but I do think the use in the man page is quite acceptable.) Cheers, Michael -- Michael Kerrisk maintainer of Linux man pages Sections 2, 3, 4, 5, and 7 Want to help with man page maintenance? Grab the latest tarball at http://www.kernel.org/pub/linux/docs/manpages/ read the HOWTOHELP file and grep the source files for 'FIXME'. -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
