aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/set_color.txt
blob: 94e8b8696429a361d2ef8848f62263e5a097e935 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
\section set_color set_color - set the terminal color

\subsection set_color-synopsis Synopsis
 <tt>set_color [-v --version] [-h --help] [-b --background COLOR] [COLOR]</tt>

\subsection set_color-description Description

Change the foreground and/or background color of the terminal.
COLOR is one of black, red, green, brown, yellow, blue, magenta,
purple, cyan, white and normal.

- \c -b, \c --background Set the background color
- \c -c, \c --print-colors Prints a list of all valid color names
- \c -h, \c --help Display help message and exit
- \c -o, \c --bold Set bold or extra bright mode
- \c -u, \c --underline Set underlined mode
- \c -v, \c --version Display version and exit


Calling <tt>set_color normal</tt> will set the terminal color to
whatever is the default color of the terminal.

Some terminals use the --bold escape sequence to switch to a brighter
color set. On such terminals, <code>set_color white</code> will result
in a grey font color, while <code>set_color --bold white</code> will
result in a white font color.

Not all terminal emulators support all these features. This is not a
bug in set_color but a missing feature in the terminal emulator.

set_color uses the terminfo database to look up how to change terminal
colors on whatever terminal is in use. Some systems have old and
incomplete terminfo databases, and may lack color information for
terminals that support it. Download and install the latest version of
ncurses and recompile fish against it in order to fix this issue.