]> Savannah Git Hosting - gnulib.git/commitdiff
access: Document limitations on Windows.
authorBruno Haible <bruno@clisp.org>
Sat, 28 Sep 2019 13:29:05 +0000 (15:29 +0200)
committerBruno Haible <bruno@clisp.org>
Sat, 28 Sep 2019 13:29:05 +0000 (15:29 +0200)
Suggested by Zaretskii <eliz@gnu.org>.

* doc/posix-functions/access.texi: Mention two limitations on Windows.

ChangeLog
doc/posix-functions/access.texi

index 3b48b42d33054c4d6df5ab02e04a9a15f073316f..cde7792e1a9e7bbc42ef7a772af554f192746731 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,4 +1,10 @@
-2019-09-15  Bruno Haible  <bruno@clisp.org>
+2019-09-28  Bruno Haible  <bruno@clisp.org>
+
+       access: Document limitations on Windows.
+       Suggested by Zaretskii <eliz@gnu.org>.
+       * doc/posix-functions/access.texi: Mention two limitations on Windows.
+
+2019-09-28  Bruno Haible  <bruno@clisp.org>
 
        findprog-in: Fix comment.
        Reported by Eli Zaretskii <eliz@gnu.org>.
index 49064d2bb00c18429feb5ba10abe32ba308a7929..8bfa2c1a67bf798a381a2b766cadf2104b5dfabc 100644 (file)
@@ -31,4 +31,17 @@ this function, especially in a set-uid or set-gid program.
 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.
+@item
+On native Windows, files whose basename does not contain a @samp{.}
+cannot be executed through @code{execlp} or @code{execvp}.  Nevertheless,
+this function may return true for such files.
+@item
+On Windows, different facilities for executing a program have different
+ways of finding an executable file, by trying various suffixes.  For
+example, @code{execlp} and @code{execvp} search for files with the
+suffixes @code{.com}, @code{.exe}, @code{.bat}, @code{.cmd}, when the
+file with the given file name does not exist.  Whereas @code{cmd.exe}
+searches according to the @code{PATHEXT} environment variable.  This
+function does not perform any search; it merely looks at the file with
+the given file name.
 @end itemize