kc3-lang/gnulib/doc/posix-functions/mkdir.texi

• Show log

  Commit

• Hash : 984cbda2
  Author :
  Date : 2024-12-27T23:40:10
  

  Rename module sys_stat to sys_stat-h.
  
  * modules/sys_stat-h: Renamed from modules/sys_stat.
  * modules/sys_stat-h-tests: Renamed from modules/sys_stat-tests.
  * modules/sys_stat-h-c++-tests: Renamed from modules/sys_stat-c++-tests.
  * tests/test-sys_stat-h.c: Renamed from tests/test-sys_stat.c.
  * tests/test-sys_stat-h-c++.cc: Renamed from tests/test-sys_stat-c++.cc.
  * doc/posix-headers/sys_stat.texi: Update.
  * doc/posix-functions/mkdir.texi: Update.
  * modules/* (Depends-on): Update.
  * modules/sys_stat: New file.
  

Download

• doc/posix-functions/mkdir.texi

• @node mkdir
  @subsection @code{mkdir}
  @findex mkdir
  
  POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/functions/mkdir.html}
  
  Gnulib module: sys_stat-h or mkdir
  @mindex sys_stat-h
  @mindex mkdir
  
  Portability problems fixed by either Gnulib module @code{sys_stat-h} 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
  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:
  @smallexample
  #define mkdir ((int (*)()) _mkdir)
  @end smallexample
  or
  @smallexample
  #define mkdir(path,mode) _mkdir (path)
  @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
  

Download