From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 23 Jan 2026 08:02:37 +0000 (+0200)
Subject: gdb: Document recent enhancements when using Windows Terminal
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a42a40e02c0df7e42559a0ff74558e3014a3259b;p=thirdparty%2Fbinutils-gdb.git

gdb: Document recent enhancements when using Windows Terminal

	* gdb/NEWS:
	* gdb/doc/gdb.texinfo (Output Styling): Document support for
	24-bit colors and UTF-8 output, including emoji styling.
---

diff --git a/gdb/NEWS b/gdb/NEWS
index 74fc353d7e9..f50568e7f0c 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -57,6 +57,15 @@
 
 * Support for Floating Point Mode Register (FPMR) in AArch64.
 
+* When running on the Windows Terminal console, GDB now supports
+  true-color 24-bit colors.
+
+* When running on the Windows Terminal console whose output codepage
+  is 65001, GDB now supports emoji styling and display of UTF-8
+  encoded text in general.  The host charset in that case will be
+  automatically set to UTF-8.  (Users can use the Windows 'chcp'
+  command to change the output codepage of the console.)
+
 * New targets
 
 GNU/Linux/MicroBlaze (gdbserver) microblazeel-*linux*
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 7059f73935c..80f49e21b7e 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -28259,8 +28259,9 @@ Show the current state of styling.
 Enable or disable the use of emoji.  On most hosts, the default is
 @samp{auto}, meaning that emoji will only be used if the host
 character set is @samp{UTF-8}; however, on Windows the default is
-@samp{off} when using the console.  Note that disabling styling as a
-whole will also prevent emoji display.
+@samp{off} when using the console, unless the console's output
+codepage is 65001, the Windows UTF-8 codepage.  Note that disabling
+styling as a whole will also prevent emoji display.
 
 Currently, emoji are printed whenever @value{GDBN} reports an error or
 a warning.