summaryrefslogtreecommitdiff
path: root/doc/posix-functions/mkdir.texi
diff options
context:
space:
mode:
authorBruno Haible <bruno@clisp.org>2020-12-25 18:39:47 +0100
committerBruno Haible <bruno@clisp.org>2020-12-25 18:39:47 +0100
commit2debee31183d819dab80fb68ead29ea34143e873 (patch)
treeabd860ee2f49f9b65ae5b5bc3e8bff468edaed20 /doc/posix-functions/mkdir.texi
parent52c7413a808f2db9658e86183a122f3028ed88b8 (diff)
downloadgnulib-2debee31183d819dab80fb68ead29ea34143e873.tar.gz
Make it possible to turn off the mkdir override on Windows.
* lib/sys_stat.in.h (mkdir): Conditionalize through GNULIB_MKDIR and GNULIB_MDA_MKDIR. Also support GNULIB_POSIXCHECK. * m4/sys_stat_h.m4 (gl_SYS_STAT_H_DEFAULTS): Initialize GNULIB_MKDIR, GNULIB_MDA_MKDIR. * modules/sys_stat (Makefile.am): Substitute GNULIB_MKDIR, GNULIB_MDA_MKDIR. * modules/mkdir (configure.ac): Invoke gl_SYS_STAT_MODULE_INDICATOR. * doc/posix-functions/mkdir.texi: Mention also the 'sys_stat' module.
Diffstat (limited to 'doc/posix-functions/mkdir.texi')
-rw-r--r--doc/posix-functions/mkdir.texi20
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/posix-functions/mkdir.texi b/doc/posix-functions/mkdir.texi
index 141d35d289..1162947fac 100644
--- a/doc/posix-functions/mkdir.texi
+++ b/doc/posix-functions/mkdir.texi
@@ -4,21 +4,15 @@
POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/mkdir.html}
-Gnulib module: mkdir
+Gnulib module: sys_stat or mkdir
-Portability problems fixed by Gnulib:
+Portability problems fixed by either Gnulib module @code{sys_stat} or @code{mkdir}:
@itemize
@item
This function is declared in different header files (namely, @code{<io.h>} or
@code{<direct.h>}) on some platforms:
mingw, MSVC 14.
@item
-When the argument ends in a slash, the function call fails on some platforms.
-@item
-This function mistakenly succeeds on @samp{mkdir("d/./",mode)} on
-some platforms:
-Cygwin 1.5.x, mingw, MSVC 14.
-@item
On Windows platforms (excluding Cygwin), this function is called @code{_mkdir}
and takes only one argument. The fix (without Gnulib) is to define a macro
like this:
@@ -31,6 +25,16 @@ or
@end smallexample
@end itemize
+Portability problems fixed by Gnulib module @code{mkdir}:
+@itemize
+@item
+When the argument ends in a slash, the function call fails on some platforms.
+@item
+This function mistakenly succeeds on @samp{mkdir("d/./",mode)} on
+some platforms:
+Cygwin 1.5.x, mingw, MSVC 14.
+@end itemize
+
Portability problems not fixed by Gnulib:
@itemize
@end itemize