Merge branch 'stable'

[gnulib.git] / doc / posix-functions / realpath.texi

diff --git a/doc/posix-functions/realpath.texi b/doc/posix-functions/realpath.texi
index 2515254..38cc8ca 100644 (file)
--- a/doc/posix-functions/realpath.texi
+++ b/doc/posix-functions/realpath.texi
@@ -2,24 +2,40 @@
 @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, MSVC 9, BeOS.
+@item
+This function does not allow for a NULL @samp{resolved} parameter on
+some platforms:
+MacOS X 10.5, FreeBSD 6.4, OpenBSD 4.4, Solaris 10.
+@item
+This function does not always return an absolute path on some
+platforms:
+Solaris 10.
+@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.
+@item
+This function misbehaves on consecutive slashes on some platforms:
+AIX 7.
 @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.