X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Frealpath.texi;h=bcc10940d61553b126b4949850781ac8bc1ee102;hb=beae0bdcf7fe30f2415c16f6b8c1368d469e519c;hp=2a0db8385ebe9e07115bd2a01910d80115440683;hpb=2b6c08c775ae4e80b52aa41058ea5939f778b44b;p=gnulib.git diff --git a/doc/posix-functions/realpath.texi b/doc/posix-functions/realpath.texi index 2a0db8385..bcc10940d 100644 --- 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/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, MSVC 9, BeOS. +@item +This function does not allow for a NULL @samp{resolved} parameter on +some platforms: +Mac OS 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; -PATH_MAX --- if it is defined --- is nothing more than a guess. +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.