X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Faccess.texi;h=fe66ae01fcb3cecb0c2fe90b7a4e9c5bbe83c5c0;hb=f40e1532834adc754cac576a07d43b9556f89a97;hp=0969c0f0a0c7af3c0f8258c2b3ac8c6fed43e8c3;hpb=2b6c08c775ae4e80b52aa41058ea5939f778b44b;p=gnulib.git

diff --git a/doc/posix-functions/access.texi b/doc/posix-functions/access.texi
index 0969c0f0a..fe66ae01f 100644
--- a/doc/posix-functions/access.texi
+++ b/doc/posix-functions/access.texi
@@ -2,7 +2,7 @@
 @section @code{access}
 @findex access
 
-POSIX specification: @url{http://www.opengroup.org/susv3xsh/access.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/access.html}
 
 Gnulib module: ---
 
@@ -12,4 +12,20 @@ Portability problems fixed by Gnulib:
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function uses the effective id instead of the real id on some
+platforms:
+Cygwin 1.5.x.
+@end itemize
+
+Other problems of this function:
+@itemize
+@item
+There is an inherent race between calling this function and performing
+some action based on the results; you should think twice before trusting
+this function, especially in a set-uid or set-gid program.
+@item
+This function does not have an option for not following symbolic links
+(like @code{stat} versus @code{lstat}).  If you need this option, use
+the Gnulib module @code{faccessat} with the @code{AT_EACCESS} flag.
 @end itemize