procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Fix last documentation change

Browse source 
* 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)
This commit is contained in:
Eli Zaretskii 2024-10-18 15:46:17 +03:00
parent 2c640e63a8
commit 19049efd30
3 changed files with 22 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

18
doc/emacs/cmdargs.texi
View file

@ -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 @var{num} were 0, i.e., it uses the terminal's default color support
mode. mode.
@end table @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} This option has no effect on MS-Windows and MS-DOS.
frame parameter, and it can be changed by modifying that frame parameter.
This means you can also specify the initial value via @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. @code{default-frame-alist} instead of the command-line option.
@end table @end table

3
doc/lispref/frames.texi
View file

@ -2447,7 +2447,8 @@ off color support.
If the parameter's value is a symbol, it specifies a number through 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 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} @vindex screen-gamma@r{, a frame parameter}
@item screen-gamma @item screen-gamma

7
doc/misc/efaq.texi
View file

@ -1889,12 +1889,17 @@ putting the following in your init file:
(push '(tty-color-mode . no) default-frame-alist) (push '(tty-color-mode . no) default-frame-alist)
@end lisp @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 @lisp
(set-frame-parameter nil 'tty-color-mode 'no) (set-frame-parameter nil 'tty-color-mode 'no)
@end lisp @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 The command @kbd{M-x list-colors-display} pops up a window which
exhibits all the colors Emacs knows about on the current display. exhibits all the colors Emacs knows about on the current display.