doc: fix comments in recent patches

* lib/faccessat.c: Mention correct function.
* lib/fchmodat.c: Likewise.
* lib/fchownat.c: Likewise.
* lib/symlinkat.c: Likewise.
* doc/posix-headers/fcntl.texi (fcntl.h): Cygwin 1.7 has AT_*
constants.

Signed-off-by: Eric Blake <ebb9@byu.net>

diff --git a/ChangeLog b/ChangeLog
index e5ebf06cdc8e70d5741f72058af55262e2132f2b..04e5cc1956d5cb4ab3a2f4c5fd9fa6fc6d55496f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
 2009-09-06  Eric Blake  <ebb9@byu.net>
 
+       doc: fix comments in recent patches
+       * lib/faccessat.c: Mention correct function.
+       * lib/fchmodat.c: Likewise.
+       * lib/fchownat.c: Likewise.
+       * lib/symlinkat.c: Likewise.
+       * doc/posix-headers/fcntl.texi (fcntl.h): Cygwin 1.7 has AT_*
+       constants.
+
        faccessat, symlinkat: continue cleanup of previous patch
        * m4/symlinkat.m4 (gl_FUNC_SYMLINKAT): Ensure dependency order.
        * m4/faccessat.m4 (gl_FUNC_FACCESSAT): Likewise.

diff --git a/doc/posix-headers/fcntl.texi b/doc/posix-headers/fcntl.texi
index 55d3ccf8f3e6cfc82aab0b437881ad5507eca273..340cf28f95753f7553b95236b7dd282dcc54d03f 100644 (file)
--- a/doc/posix-headers/fcntl.texi
+++ b/doc/posix-headers/fcntl.texi
@@ -30,7 +30,8 @@ mingw.
 @samp{AT_FDCWD}, @samp{AT_EACCESS}, @samp{AT_SYMLINK_NOFOLLOW},
 @samp{AT_SYMLINK_FOLLOW}, and @samp{AT_REMOVEDIR}
 are not defined on many platforms:
-glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 8, Cygwin, mingw, Interix 3.5, BeOS.
+glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
+5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 8, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
 
 @item
 @samp{AT_FDCWD} is defined with a value too large for an @code{int} on some

diff --git a/lib/faccessat.c b/lib/faccessat.c
index a449b021720e2c470b0150f51737201cdc3a9e77..42479c7fdfa3dd0278420a39f47ba8a93c28c569 100644 (file)
--- a/lib/faccessat.c
+++ b/lib/faccessat.c
@@ -34,9 +34,9 @@
 
 /* Invoke access or euidaccess on file, FILE, using mode MODE, in the directory
    open on descriptor FD.  If possible, do it without changing the
-   working directory.  Otherwise, resort to using save_cwd/fchdir,
-   then mkdir/restore_cwd.  If either the save_cwd or the restore_cwd
-   fails, then give a diagnostic and exit nonzero.
+   working directory.  Otherwise, resort to using save_cwd/fchdir, then
+   (access|euidaccess)/restore_cwd.  If either the save_cwd or the
+   restore_cwd fails, then give a diagnostic and exit nonzero.
    Note that this implementation only supports AT_EACCESS, although some
    native versions also support AT_SYMLINK_NOFOLLOW.  */
 

diff --git a/lib/fchmodat.c b/lib/fchmodat.c
index cc2776eb1ee784b8d187f799264f7ac361eb65e2..53cafe06d5f5ab1d741895b5bd2a57a1b2c84714 100644 (file)
--- a/lib/fchmodat.c
+++ b/lib/fchmodat.c
@@ -37,8 +37,8 @@ static int lchmod (char const *f, mode_t m) { errno = ENOSYS; return -1; }
    Invoke chmod or lchmod on file, FILE, using mode MODE, in the directory
    open on descriptor FD.  If possible, do it without changing the
    working directory.  Otherwise, resort to using save_cwd/fchdir,
-   then mkdir/restore_cwd.  If either the save_cwd or the restore_cwd
-   fails, then give a diagnostic and exit nonzero.
+   then (chmod|lchmod)/restore_cwd.  If either the save_cwd or the
+   restore_cwd fails, then give a diagnostic and exit nonzero.
    Note that an attempt to use a FLAG value of AT_SYMLINK_NOFOLLOW
    on a system without lchmod support causes this function to fail.  */
 

diff --git a/lib/fchownat.c b/lib/fchownat.c
index ba5d86baf430f57dd918573145c1e14c35c7bf49..6da3537340c7f8daa12809fa4cd0afe1ee58f3bd 100644 (file)
--- a/lib/fchownat.c
+++ b/lib/fchownat.c
@@ -35,8 +35,8 @@
    directory open on descriptor FD.  If FLAG is AT_SYMLINK_NOFOLLOW, then
    use lchown, otherwise, use chown.  If possible, do it without changing
    the working directory.  Otherwise, resort to using save_cwd/fchdir,
-   then mkdir/restore_cwd.  If either the save_cwd or the restore_cwd
-   fails, then give a diagnostic and exit nonzero.  */
+   then (chown|lchown)/restore_cwd.  If either the save_cwd or the
+   restore_cwd fails, then give a diagnostic and exit nonzero.  */
 
 #define AT_FUNC_NAME fchownat
 #define AT_FUNC_F1 lchown

diff --git a/lib/symlinkat.c b/lib/symlinkat.c
index 6c1c1d5fbdc23a75f8cbff967a960f4bcee451aa..6fe752f14aca86dbf6a57671553f5a67637486ed 100644 (file)
--- a/lib/symlinkat.c
+++ b/lib/symlinkat.c
@@ -68,7 +68,7 @@ symlinkat_reversed (int fd, char const *file, char const *contents);
 /* Create a symlink FILE, in the directory open on descriptor FD,
    holding CONTENTS.  If possible, do it without changing the
    working directory.  Otherwise, resort to using save_cwd/fchdir,
-   then mkdir/restore_cwd.  If either the save_cwd or the restore_cwd
+   then symlink/restore_cwd.  If either the save_cwd or the restore_cwd
    fails, then give a diagnostic and exit nonzero.  */
 
 int
@@ -90,7 +90,7 @@ symlinkat (char const *contents, int fd, char const *file)
 /* Read the contents of symlink FILE into buffer BUF of size LEN, in the
    directory open on descriptor FD.  If possible, do it without changing
    the working directory.  Otherwise, resort to using save_cwd/fchdir,
-   then mkdir/restore_cwd.  If either the save_cwd or the restore_cwd
+   then readlink/restore_cwd.  If either the save_cwd or the restore_cwd
    fails, then give a diagnostic and exit nonzero.  */
 
 #define AT_FUNC_NAME readlinkat