[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Documentation of GREP_COLORS in doc/grep.1

From: Julian Foad
Subject: Documentation of GREP_COLORS in doc/grep.1
Date: Mon, 04 Jul 2005 19:31:33 +0100
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8b) Gecko/20050217

Charles Levert wrote:
Index: grep/doc/grep.1
diff -u grep/doc/grep.1:1.29 grep/doc/grep.1:1.30
--- grep/doc/grep.1:1.29        Mon Apr 11 23:56:01 2005
+++ grep/doc/grep.1     Tue Jun 21 14:58:50 2005
@@ -12,7 +12,7 @@
 .de Id
 .ds Dt \\$4
-.Id $Id: grep.1,v 1.29 2005/04/11 23:56:01 julianfoad Exp $
+.Id $Id: grep.1,v 1.30 2005/06/21 14:58:50 charles_levert Exp $
 .TH GREP 1 \*(Dt "GNU Project"
 grep, egrep, fgrep \- print lines matching a pattern
@@ -126,11 +126,35 @@
 which can have nasty side effects if the output is a terminal and if the
 terminal driver interprets some of it as commands.
-.BI \-\^\-colour[=\fIWHEN\fR] ", " \-\^\-color[=\fIWHEN\fR]
-Surround the matching strings with escape sequences to display them in color
-on the terminal.  The color is defined by the environment variable
+.BI \-\^\-color[=\fIWHEN\fR] ", " \-\^\-colour[=\fIWHEN\fR]
+Surround the matching strings, matchings lines, context lines, file

"matching lines"

+names, line numbers, octet offsets, and separators (for fields and
+groups of context lines) with escape sequences to display them in color
+on the terminal.
+The colors are defined by the environment variable
+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.

The rest of this description ...

+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.
+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).

... up to here would be better placed under the entry for the GREP_COLORS environment variable, like you have done in the "grep.texi" file.

+The deprecated environment variable
-and defaults to `01;31' which means the text is red.
+is still supported, but its setting does not have priority; it defaults to
+`01;31' (bold red) which only covers the color for matched text.
 is `never', `always', or `auto'.
@@ -700,8 +724,15 @@
 so it can be used to specify an option containing whitespace or a backslash.
+Deprecated in favor of
+which has priority.
 Specifies the marker for highlighting.
+Specifies the markers for highlighting matched text, file names,

And matching lines and context lines.

+line numbers, octet offsets, and separators.
 These variables specify the


reply via email to

[Prev in Thread] Current Thread [Next in Thread]