X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Frealpath.texi;h=5f7495be27edfd613d1118bebe376f8c425feb13;hb=23737e3dd01ef6ac0ae9134300a4c66807ae00d2;hp=2a0db8385ebe9e07115bd2a01910d80115440683;hpb=2b6c08c775ae4e80b52aa41058ea5939f778b44b;p=gnulib.git

diff --git a/doc/posix-functions/realpath.texi b/doc/posix-functions/realpath.texi
index 2a0db8385..5f7495be2 100644
--- a/doc/posix-functions/realpath.texi
+++ b/doc/posix-functions/realpath.texi
@@ -2,24 +2,37 @@
 @section @code{realpath}
 @findex realpath
 
-POSIX specification: @url{http://www.opengroup.org/susv3xsh/realpath.html}
+POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/realpath.html}
 
-Gnulib module: ---
+Gnulib module: canonicalize-lgpl
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+This function is missing on some platforms:
+mingw, BeOS.
+@item
+This function does not allow for a NULL @samp{resolved} parameter on
+some platforms:
+Solaris.
+@item
+This function does not always return an absolute path on some
+platforms:
+Solaris.
+@item
+This function fails to detect trailing slashes on non-directories on
+some platforms:
+glibc 2.3.5.
+@item
+This function fails to recognize non-directories followed @samp{..} on
+some platforms:
+cygwin.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw, BeOS.
-@item
 This function does not allow to determine the required size of output buffer;
+the use of a non-NULL @samp{resolved} buffer is non-portable, since
 PATH_MAX --- if it is defined --- is nothing more than a guess.
 @end itemize
-
-Extension: Gnulib provides a module @samp{canonicalize-lgpl} that defines a
-function @code{canonicalize_file_name} that is like @code{realpath} but without
-size limitations.