From: Bruno Haible <bruno@clisp.org>
Date: Thu, 12 Jun 2025 22:02:57 +0000 (+0200)
Subject: stat: Document mingw bug.
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2b918f2e68b801daf7a4268d611c1ed9cbee1574;p=thirdparty%2Fgnulib.git

stat: Document mingw bug.

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

diff --git a/ChangeLog b/ChangeLog
index a12a1707c9..cb4853e4b3 100644
--- 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 160e86b978..6e0df396a5 100644
--- 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