Explain tty-color-mode frame parameter more.

* doc/emacs/cmdargs.texi (Colors X): Explain that tty color
support is dynamic.
* doc/lispref/frames.texi (Font and Color Parameters): Explain
that 'tty-color-mode' can be changed on the fly.
* doc/misc/efaq.texi (Colors on a TTY): Explain how to disable
'tty-color-mode', either at startup or dynamically.

1 files changed, 15 insertions, 0 deletions

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.