X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fposix-functions%2Ffchmodat.texi;h=3808f93573f81e7719f8b65fea9bdfc5a7a6fa9c;hb=fc80165c92e8b92da6e88e4fdb9c472125124fa0;hp=1cca96ca56f433673fcd60e74924980ccbf40133;hpb=17f87c3231d8808b8e873126abf15e6e8b9a0e67;p=gnulib.git

diff --git a/doc/posix-functions/fchmodat.texi b/doc/posix-functions/fchmodat.texi
index 1cca96ca5..3808f9357 100644
--- a/doc/posix-functions/fchmodat.texi
+++ b/doc/posix-functions/fchmodat.texi
@@ -4,15 +4,24 @@
 
 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/fchmodat.html}
 
-Gnulib module: ---
+Gnulib module: openat
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+This function is missing on some 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 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some 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 10, Cygwin, mingw, Interix 3.5, BeOS.
+Some platforms do not allow changing the access bits on symbolic
+links.  POSIX states that @code{fchmodat(@dots{},AT_SYMLINK_NOFOLLOW)}
+may fail with @code{EOPNOTSUPP} when called on a symlink, but some
+platforms, as well as the gnulib replacement, fail for any use of
+AT_SYMLINK_NOFOLLOW even if the target was not a symlink:
+glibc, Cygwin.
 @end itemize