stat: Document mingw bug.

* doc/posix-functions/stat.texi: Mention the bug with NUL on mingw.

diff --git a/ChangeLog b/ChangeLog
index a12a1707c95695e61f96d541c6620eb9fc095973..cb4853e4b37252fc1abb35d018c3302faf02e5ae 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2025-06-12  Bruno Haible  <bruno@clisp.org>
+
+       stat: Document mingw bug.
+       * doc/posix-functions/stat.texi: Mention the bug with NUL on mingw.
+
 2025-06-12  Bruno Haible  <bruno@clisp.org>
 
        stat: Add support for mingw 13 in 32-bit mode.

diff --git a/doc/posix-functions/stat.texi b/doc/posix-functions/stat.texi
index 160e86b9782275f8b9cac36f19bb6bbb091338e4..6e0df396a521b689b87e33addf42512209096420 100644 (file)
--- a/doc/posix-functions/stat.texi
+++ b/doc/posix-functions/stat.texi
@@ -36,6 +36,10 @@ On some platforms, @code{stat(".",buf)} and @code{stat("./",buf)} give
 different results:
 mingw, MSVC 14.
 @item
+@c https://sourceforge.net/p/mingw-w64/bugs/1009/
+On mingw, the @code{st_mode} field of @code{stat("NUL",buf)} is bogus,
+suggesting that @code{NUL} is a regular file.
+@item
 On macOS 12.6, when this function yields a timestamp with a
 nonpositive @code{tv_sec} value, @code{tv_nsec} might be in the range
 @minus{}999999999..@minus{}1, representing a negative nanoseconds