/[grep]/grep/doc/grep.1
ViewVC logotype

Diff of /grep/doc/grep.1

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.31 by charles_levert, Tue Jun 21 15:22:58 2005 UTC revision 1.32 by charles_levert, Tue Jul 5 01:03:33 2005 UTC
# Line 127  which can have nasty side effects if the Line 127  which can have nasty side effects if the
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
# Line 743  so it can be used to specify an option c Line 724  so it can be used to specify an option c
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

Legend:
Removed from v.1.31  
changed lines
  Added in v.1.32

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26