127 |
terminal driver interprets some of it as commands. |
terminal driver interprets some of it as commands. |
128 |
.TP |
.TP |
129 |
.BI \-\^\-color[=\fIWHEN\fR] ", " \-\^\-colour[=\fIWHEN\fR] |
.BI \-\^\-color[=\fIWHEN\fR] ", " \-\^\-colour[=\fIWHEN\fR] |
130 |
Surround the matching strings, matchings lines, context lines, file |
Surround the matching strings, matching lines, context lines, file |
131 |
names, line numbers, octet offsets, and separators (for fields and |
names, line numbers, octet offsets, and separators (for fields and |
132 |
groups of context lines) with escape sequences to display them in color |
groups of context lines) with escape sequences to display them in color |
133 |
on the terminal. |
on the terminal. |
134 |
The colors are defined by the environment variable |
The colors are defined by the environment variable |
135 |
.B GREP_COLORS |
.BR GREP_COLORS . |
|
and default to `mt=01;31:ml=:cx=:fn=35:ln=32:bn=32:se=36' for bold red |
|
|
matched text, default matching lines, default context lines, |
|
|
magenta file names, green line numbers, green octet offsets, |
|
|
and cyan separators. |
|
|
Note that the `ml' setting, if any, remains in effect just before the |
|
|
`mt' setting kicks in. |
|
|
See the Select Graphic Rendition (SGR, for character attributes) |
|
|
section in the documentation of the text terminal that is used |
|
|
for permissible values (semicolon-separated lists of integers) |
|
|
and their meaning. |
|
|
.B GREP_COLORS |
|
|
also supports a boolean `ne' capability (with no `=...' part) to not |
|
|
clear to the end of line using Erase in Line (EL) to Right (`\\33[K') |
|
|
each time a colorized item ends (needed on terminals on which EL is not |
|
|
supported; otherwise useful on terminals where the `back_color_erase' |
|
|
(`bce') boolean terminfo capability is not specified, when the chosen |
|
|
highlight colors do not affect the background, or when EL is too slow |
|
|
to bother doing or causes too much flicker). |
|
136 |
The deprecated environment variable |
The deprecated environment variable |
137 |
.B GREP_COLOR |
.B GREP_COLOR |
138 |
is still supported, but its setting does not have priority; it defaults to |
is still supported, but its setting does not have priority. |
|
`01;31' (bold red) which only covers the color for matched text. |
|
139 |
.I WHEN |
.I WHEN |
140 |
is `never', `always', or `auto'. |
is `never', `always', or `auto'. |
141 |
.TP |
.TP |
724 |
Deprecated in favor of |
Deprecated in favor of |
725 |
.BR GREP_COLORS , |
.BR GREP_COLORS , |
726 |
which has priority. |
which has priority. |
727 |
Specifies the marker for highlighting. |
It can only specify the marker for highlighting matched text and |
728 |
|
defaults to `01;31' (bold red). |
729 |
.TP |
.TP |
730 |
.B GREP_COLORS |
.B GREP_COLORS |
731 |
Specifies the markers for highlighting matched text, file names, |
Specifies the markers for highlighting matched text (mt), matching lines |
732 |
line numbers, octet offsets, and separators. |
(ml), context lines (cx), file names (fn), line numbers (ln), octet |
733 |
|
offsets (bn), and separators (se, for fields and groups of context lines). |
734 |
|
It is a colon-separated list of color specification assignments. |
735 |
|
The default is `mt=01;31:ml=:cx=:fn=35:ln=32:bn=32:se=36' which means |
736 |
|
bold red, default, default, magenta, green, green, and cyan, all text |
737 |
|
foregrounds on the default background. |
738 |
|
Note that the `ml' setting, if any, remains in effect just before the |
739 |
|
`mt' setting kicks in. |
740 |
|
See the Select Graphic Rendition (SGR, for character attributes) |
741 |
|
section in the documentation of the text terminal that is used |
742 |
|
for permissible values (semicolon-separated lists of integers) |
743 |
|
and their meaning. |
744 |
|
.B GREP_COLORS |
745 |
|
also supports a boolean `ne' capability (with no `=...' part) to not |
746 |
|
clear to the end of line using Erase in Line (EL) to Right (`\\33[K') |
747 |
|
each time a colorized item ends (needed on terminals on which EL is not |
748 |
|
supported; otherwise useful on terminals where the `back_color_erase' |
749 |
|
(`bce') boolean terminfo capability is not specified, when the chosen |
750 |
|
highlight colors do not affect the background, or when EL is too slow |
751 |
|
to bother doing or causes too much flicker). |
752 |
.TP |
.TP |
753 |
\fBLC_ALL\fP, \fBLC_COLLATE\fP, \fBLANG\fP |
\fBLC_ALL\fP, \fBLC_COLLATE\fP, \fBLANG\fP |
754 |
These variables specify the |
These variables specify the |