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 73b7ff269ceeceb8a813b342c284d0376f79d130..d6a4df6cd0315b83621414c5fe9dac4e6ff5d192 100644 (file)
--- 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 de80da596c3684c4090fe1e75c91c52e40157512..892243ae877d2e08cfd3c469cfd98a11c2b6c7fb 100644 (file)
--- 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 5cd99e5940d9d337b42c64a95fb0843af73a6d34..3922a9f1db61c7b58ca925cde27287d5590ca6bd 100644 (file)
--- 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 aec5b7e7d802c3c151cf2024169948cb742747f8..e95660163183ece9418349d03d08387f204e86bd 100644 (file)
--- 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.