diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi index ba4b45d272b..9b72b883628 100644 --- a/doc/emacs/cmdargs.texi +++ b/doc/emacs/cmdargs.texi @@ -1027,7 +1027,11 @@ 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}. +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 +@code{default-frame-alist} instead of the command-line option. @end table For example, to use a coral mouse cursor and a slate blue text cursor, diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 8744687a531..694f33af8ee 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -2447,7 +2447,7 @@ 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. +used instead. This parameter supports dynamic changes. @vindex screen-gamma@r{, a frame parameter} @item screen-gamma diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index 8c3b81a5fe5..8a7a11071da 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi @@ -1880,6 +1880,21 @@ think that your terminal supports colors, but Emacs won't use them, check the @code{termcap} entry for your display type for color-related capabilities. +If by contrast you wish to @emph{disable} tty color support, either +start emacs with the @samp{--color=no} command-line option, or ensure +that the frame parameter @code{tty-color-mode} is @code{no}, e.g. by +putting the following in your init file: + +@lisp +(push '(tty-color-mode . no) default-frame-alist) +@end lisp + +To disable tty color support in the @emph{current} frame you can run: + +@lisp +(set-frame-parameter nil 'tty-color-mode 'no) +@end lisp + The command @kbd{M-x list-colors-display} pops up a window which exhibits all the colors Emacs knows about on the current display.