From: Bruno Haible <bruno@clisp.org>
Date: Tue, 16 Sep 2025 15:08:44 +0000 (+0200)
Subject: Document msvcrt (native Windows) bugs regarding console output.
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=901563ae363e4816b9b7ecdb154910e18b6052ca;p=thirdparty%2Fgnulib.git

Document msvcrt (native Windows) bugs regarding console output.

* doc/posix-functions/fputc.texi: Document a bug found in msvcrt.
* doc/posix-functions/putc.texi: Likewise.
* doc/posix-functions/fwrite.texi: Document another bug found in msvcrt.
---

diff --git a/ChangeLog b/ChangeLog
index 73b7ff269c..d6a4df6cd0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2025-09-16  Bruno Haible  <bruno@clisp.org>
+
+	Document msvcrt (native Windows) bugs regarding console output.
+	* doc/posix-functions/fputc.texi: Document a bug found in msvcrt.
+	* doc/posix-functions/putc.texi: Likewise.
+	* doc/posix-functions/fwrite.texi: Document another bug found in msvcrt.
+
 2025-09-16  Bruno Haible  <bruno@clisp.org>
 
 	strerror_r: Ensure a trailing NUL when truncating.
diff --git a/doc/posix-functions/fputc.texi b/doc/posix-functions/fputc.texi
index de80da596c..892243ae87 100644
--- a/doc/posix-functions/fputc.texi
+++ b/doc/posix-functions/fputc.texi
@@ -32,6 +32,12 @@ Portability problems not fixed by Gnulib:
 On Windows platforms (excluding Cygwin), this function does not set @code{errno}
 upon failure.
 @item
+This function fails and produces garbled output
+when invoked twice, for outputting a non-ASCII character in double-byte encoding,
+corresponding to the locale, on some platforms:
+mingw in combination with msvcrt,
+when the output goes to a Windows console.
+@item
 On some platforms, this function does not set @code{errno} or the
 stream error indicator on attempts to write to a read-only stream:
 Cygwin 1.7.9.
diff --git a/doc/posix-functions/fwrite.texi b/doc/posix-functions/fwrite.texi
index 5cd99e5940..3922a9f1db 100644
--- a/doc/posix-functions/fwrite.texi
+++ b/doc/posix-functions/fwrite.texi
@@ -32,6 +32,12 @@ Portability problems not fixed by Gnulib:
 On Windows platforms (excluding Cygwin), this function does not set @code{errno}
 upon failure.
 @item
+This function fails and produces no output
+when the argument string starts with a non-ASCII character in double-byte encoding,
+corresponding to the locale, on some platforms:
+mingw in combination with msvcrt,
+when the output goes to a Windows console.
+@item
 On some platforms, this function does not set @code{errno} or the
 stream error indicator on attempts to write to a read-only stream:
 Cygwin 1.7.9.
diff --git a/doc/posix-functions/putc.texi b/doc/posix-functions/putc.texi
index aec5b7e7d8..e956601631 100644
--- a/doc/posix-functions/putc.texi
+++ b/doc/posix-functions/putc.texi
@@ -32,6 +32,12 @@ Portability problems not fixed by Gnulib:
 On Windows platforms (excluding Cygwin), this function does not set @code{errno}
 upon failure.
 @item
+This function fails and produces garbled output
+when invoked twice, for outputting a non-ASCII character in double-byte encoding,
+corresponding to the locale, on some platforms:
+mingw in combination with msvcrt,
+when the output goes to a Windows console.
+@item
 On some platforms, this function does not set @code{errno} or the
 stream error indicator on attempts to write to a read-only stream:
 Cygwin 1.7.9.