From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 18 Oct 2024 12:46:17 +0000 (+0300)
Subject: ; Fix last documentation change
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=10c5c042d45c285aa3dbb8b9006c2509036a245b;p=emacs.git

; Fix last documentation change

* doc/misc/efaq.texi (Colors on a TTY):
* doc/lispref/frames.texi (Font and Color Parameters):
* doc/emacs/cmdargs.texi (Colors X): More accurate documentation
of TTY color modes and 'tty-color-mode' frame parameter.
(Bug#73813)

(cherry picked from commit 19049efd30f5476baa4b69c4b79af15674c2650b)
---

diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi
index 9b72b883628..08e67c891a5 100644
--- a/doc/emacs/cmdargs.texi
+++ b/doc/emacs/cmdargs.texi
@@ -1027,10 +1027,20 @@ there is no mode that supports @var{num} colors, Emacs acts as if
 @var{num} were 0, i.e., it uses the terminal's default color support
 mode.
 @end table
-If @var{mode} is omitted, it defaults to @var{ansi8}.  This support is
-dynamic: the current mode is available via the @code{tty-color-mode}
-frame parameter, and it can be changed by modifying that frame parameter.
-This means you can also specify the initial value via
+
+This option has no effect on MS-Windows and MS-DOS.
+
+@cindex colors on character terminal, changing during session
+@cindex character terminal, change color mode
+@vindex tty-color-mode@r{, frame parameter}
+If @var{mode} is omitted, it defaults to @var{ansi8}.
+
+The color mode can be changed dynamically during a running Emacs
+session: the current mode is available via the @code{tty-color-mode}
+frame parameter, and it can be changed by modifying that frame
+parameter.@footnote{
+This does not work on MS-Windows and MS-DOS text-mode terminals.
+}  This means you can also specify the initial value via
 @code{default-frame-alist} instead of the command-line option.
 @end table
 
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index a01894897cf..edeba3288fc 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2447,7 +2447,8 @@ off color support.
 
 If the parameter's value is a symbol, it specifies a number through
 the value of @code{tty-color-mode-alist}, and the associated number is
-used instead.  This parameter supports dynamic changes.
+used instead.  This parameter supports dynamic changes during a running
+Emacs session (but not on MS-Windows and MS-DOS).
 
 @vindex screen-gamma@r{, a frame parameter}
 @item screen-gamma
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index cf9bce79039..4df091dbeac 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -1879,12 +1879,17 @@ putting the following in your init file:
 (push '(tty-color-mode . no) default-frame-alist)
 @end lisp
 
-To disable tty color support in the @emph{current} frame you can run:
+@noindent
+To disable tty color support in the @emph{current} frame you can
+evaluate:
 
 @lisp
 (set-frame-parameter nil 'tty-color-mode 'no)
 @end lisp
 
+Note that this currently doesn't work on MS-Windows and MS-DOS, whose
+text-mode terminals always use the fixed number of 16 text colors.
+
 The command @kbd{M-x list-colors-display} pops up a window which
 exhibits all the colors Emacs knows about on the current display.