X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Frealpath.texi;h=d5c986f926f79dcbdb8195a4fb296ee774bb9b30;hb=14b6d70139486b63e66257aad1abe2a9615f4d96;hp=2515254719bf49a262a42c229b71073cbddbd1e1;hpb=09ef7461110822a3970aa8eebcfaa740996a82f2;p=gnulib.git

diff --git a/doc/posix-functions/realpath.texi b/doc/posix-functions/realpath.texi
index 251525471..d5c986f92 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/onlinepubs/9699919799/functions/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.