Go to the source code of this file.
Macro Definition Documentation
◆ COLOR_BG_BLACK
| #define COLOR_BG_BLACK "40" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BLUE
| #define COLOR_BG_BLUE "44" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_BLACK
| #define COLOR_BG_BRIGHT_BLACK "100" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_BLUE
| #define COLOR_BG_BRIGHT_BLUE "104" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_CYAN
| #define COLOR_BG_BRIGHT_CYAN "106" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_GREEN
| #define COLOR_BG_BRIGHT_GREEN "102" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_MAGENTA
| #define COLOR_BG_BRIGHT_MAGENTA "105" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_RED
| #define COLOR_BG_BRIGHT_RED "101" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_WHITE
| #define COLOR_BG_BRIGHT_WHITE "107" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_BRIGHT_YELLOW
| #define COLOR_BG_BRIGHT_YELLOW "103" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_CYAN
| #define COLOR_BG_CYAN "46" |
Referenced by output_line_beginning(), output_lines(), and text_art::style::color::print_sgr().
◆ COLOR_BG_GREEN
| #define COLOR_BG_GREEN "42" |
Referenced by output_line_beginning(), output_lines(), and text_art::style::color::print_sgr().
◆ COLOR_BG_MAGENTA
| #define COLOR_BG_MAGENTA "45" |
Referenced by output_line_beginning(), output_lines(), and text_art::style::color::print_sgr().
◆ COLOR_BG_RED
| #define COLOR_BG_RED "41" |
Referenced by output_line_beginning(), output_lines(), and text_art::style::color::print_sgr().
◆ COLOR_BG_WHITE
| #define COLOR_BG_WHITE "47" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_BG_YELLOW
| #define COLOR_BG_YELLOW "43" |
Referenced by output_line_beginning(), output_lines(), and text_art::style::color::print_sgr().
◆ COLOR_BLINK
| #define COLOR_BLINK "05" |
Referenced by text_art::style::print_changes().
◆ COLOR_BOLD
| #define COLOR_BOLD "01" |
Referenced by text_art::style::print_changes().
◆ COLOR_FG_BLACK
| #define COLOR_FG_BLACK "30" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BLUE
| #define COLOR_FG_BLUE "34" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_BLACK
| #define COLOR_FG_BRIGHT_BLACK "90" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_BLUE
| #define COLOR_FG_BRIGHT_BLUE "94" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_CYAN
| #define COLOR_FG_BRIGHT_CYAN "96" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_GREEN
| #define COLOR_FG_BRIGHT_GREEN "92" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_MAGENTA
| #define COLOR_FG_BRIGHT_MAGENTA "95" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_RED
| #define COLOR_FG_BRIGHT_RED "91" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_WHITE
| #define COLOR_FG_BRIGHT_WHITE "97" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_BRIGHT_YELLOW
| #define COLOR_FG_BRIGHT_YELLOW "93" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_CYAN
| #define COLOR_FG_CYAN "36" |
Referenced by output_lines(), and text_art::style::color::print_sgr().
◆ COLOR_FG_GREEN
| #define COLOR_FG_GREEN "32" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_MAGENTA
| #define COLOR_FG_MAGENTA "35" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_RED
| #define COLOR_FG_RED "31" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_FG_WHITE
| #define COLOR_FG_WHITE "37" |
Referenced by output_line_beginning(), and text_art::style::color::print_sgr().
◆ COLOR_FG_YELLOW
| #define COLOR_FG_YELLOW "33" |
Referenced by text_art::style::color::print_sgr().
◆ COLOR_NONE
| #define COLOR_NONE "00" |
Referenced by text_art::style::print_changes().
◆ COLOR_REVERSE
| #define COLOR_REVERSE "07" |
◆ COLOR_SEPARATOR
| #define COLOR_SEPARATOR ";" |
Terminal color manipulation macros. Copyright (C) 2005-2025 Free Software Foundation, Inc. This file is part of GCC. GCC is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version. GCC is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GCC; see the file COPYING3. If not see <http://www.gnu.org/licenses/>.
Select Graphic Rendition (SGR, "\33[...m") strings.
Also Erase in Line (EL) to Right ("\33[K") by default. Why have EL to Right after SGR?
-- The behavior of line-wrapping when at the bottom of the
terminal screen and at the end of the current line is often
such that a new line is introduced, entirely cleared with
the current background color which may be different from the
default one (see the boolean back_color_erase terminfo(5)
capability), thus scrolling the display by one line.
The end of this new line will stay in this background color
even after reverting to the default background color with
"\33[m', unless it is explicitly cleared again with "\33[K"
(which is the behavior the user would instinctively expect
from the whole thing). There may be some unavoidable
background-color flicker at the end of this new line because
of this (when timing with the monitor's redraw is just right).
-- The behavior of HT (tab, "\t") is usually the same as that of
Cursor Forward Tabulation (CHT) with a default parameter
of 1 ("\33[I"), i.e., it performs pure movement to the next
tab stop, without any clearing of either content or screen
attributes (including background color); try
printf 'asdfqwerzxcv\rASDF\tZXCV\n'
in a bash(1) shell to demonstrate this. This is not what the
user would instinctively expect of HT (but is ok for CHT).
The instinctive behavior would include clearing the terminal
cells that are skipped over by HT with blank cells in the
current screen attributes, including background color;
the boolean dest_tabs_magic_smso terminfo(5) capability
indicates this saner behavior for HT, but only some rare
terminals have it (although it also indicates a special
glitch with standout mode in the Teleray terminal for which
it was initially introduced). The remedy is to add "\33K"
after each SGR sequence, be it START (to fix the behavior
of any HT after that before another SGR) or END (to fix the
behavior of an HT in default background color that would
follow a line-wrapping at the bottom of the screen in another
background color, and to complement doing it after START).
Piping GCC's output through a pager such as less(1) avoids
any HT problems since the pager performs tab expansion.
Generic disadvantages of this remedy are:
-- Some very rare terminals might support SGR but not EL (nobody
will use "gcc -fdiagnostics-color" on a terminal that does not
support SGR in the first place).
-- Having these extra control sequences might somewhat complicate
the task of any program trying to parse "gcc -fdiagnostics-color"
output in order to extract structuring information from it.
A specific disadvantage to doing it after SGR START is:
-- Even more possible background color flicker (when timing
with the monitor's redraw is just right), even when not at the
bottom of the screen.
There are no additional disadvantages specific to doing it after
SGR END.
It would be impractical for GCC to become a full-fledged
terminal program linked against ncurses or the like, so it will
not detect terminfo(5) capabilities.
Referenced by ensure_separator(), and output_line_beginning().
◆ COLOR_UNDERSCORE
| #define COLOR_UNDERSCORE "04" |
Referenced by text_art::style::print_changes().
◆ SGR_END
| #define SGR_END "m\33[K" |
Referenced by diagnostic_color_dict::parse_envvar_value(), and text_art::style::print_changes().
◆ SGR_RESET
| #define SGR_RESET SGR_SEQ("") |
Referenced by colorize_stop(), output_line_beginning(), and output_lines().
◆ SGR_SEQ
| #define SGR_SEQ | ( | str | ) |
Referenced by output_line_beginning(), output_lines(), and diagnostic_color_dict::parse_envvar_value().
◆ SGR_START
| #define SGR_START "\33[" |
Referenced by diagnostic_color_dict::parse_envvar_value(), and text_art::style::print_changes().
