[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Changes to grep/manual/html_node/Environment-Variables.html,v
|
From: |
Jim Meyering |
|
Subject: |
Changes to grep/manual/html_node/Environment-Variables.html,v |
|
Date: |
Tue, 23 Mar 2010 12:04:27 +0000 |
CVSROOT: /webcvs/grep
Module name: grep
Changes by: Jim Meyering <meyering> 10/03/23 12:04:22
Index: html_node/Environment-Variables.html
===================================================================
RCS file: /webcvs/grep/grep/manual/html_node/Environment-Variables.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- html_node/Environment-Variables.html 24 May 2009 18:42:58 -0000
1.1
+++ html_node/Environment-Variables.html 23 Mar 2010 12:04:18 -0000
1.2
@@ -1,8 +1,8 @@
<html lang="en">
<head>
-<title>Environment Variables - GNU Grep 2.5.4</title>
+<title>Environment Variables - GNU Grep 2.6</title>
<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="GNU Grep 2.5.4">
+<meta name="description" content="GNU Grep 2.6">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Invoking.html#Invoking" title="Invoking">
@@ -12,8 +12,8 @@
<!--
This manual is for `grep', a pattern matching engine.
-Copyright (C) 1999, 2000, 2001, 2002, 2005, 2008, 2009 Free
-Software Foundation, Inc.
+Copyright (C) 1999-2002, 2005, 2008-2010 Free Software Foundation,
+Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
@@ -64,9 +64,9 @@
or if <samp><span class="command">grep</span></samp> was not compiled
with national language support (<span class="sc">nls</span>).
- <p><a name="index-environment-variables-126"></a>
+ <p><a name="index-environment-variables-130"></a>
<dl>
-<dt><samp><span class="env">GREP_OPTIONS</span></samp><dd><a
name="index-GREP_005fOPTIONS-_0040r_007benvironment-variable_007d-127"></a><a
name="index-default-options-environment-variable-128"></a>This variable
specifies default options to be placed in front of any
+<dt><samp><span class="env">GREP_OPTIONS</span></samp><dd><a
name="index-GREP_005fOPTIONS-_0040r_007benvironment-variable_007d-131"></a><a
name="index-default-options-environment-variable-132"></a>This variable
specifies default options to be placed in front of any
explicit options.
For example, if <code>GREP_OPTIONS</code> is
‘<samp><span class="samp">--binary-files=without-match
--directories=skip</span></samp>’, <samp><span
class="command">grep</span></samp>
@@ -78,7 +78,7 @@
A backslash escapes the next character, so it can be used to
specify an option containing whitespace or a backslash.
- <br><dt><samp><span class="env">GREP_COLOR</span></samp><dd><a
name="index-GREP_005fCOLOR-_0040r_007benvironment-variable_007d-129"></a><a
name="index-highlight-markers-130"></a>This variable specifies the color used
to highlight matched (non-empty) text.
+ <br><dt><samp><span class="env">GREP_COLOR</span></samp><dd><a
name="index-GREP_005fCOLOR-_0040r_007benvironment-variable_007d-133"></a><a
name="index-highlight-markers-134"></a>This variable specifies the color used
to highlight matched (non-empty) text.
It is deprecated in favor of <code>GREP_COLORS</code>, but still supported.
The ‘<samp><span class="samp">mt</span></samp>’,
‘<samp><span class="samp">ms</span></samp>’, and ‘<samp><span
class="samp">mc</span></samp>’ capabilities of <code>GREP_COLORS</code>
have priority over it.
@@ -89,7 +89,7 @@
The default is ‘<samp><span class="samp">01;31</span></samp>’,
which means a bold red foreground text on the terminal's default background.
- <br><dt><samp><span class="env">GREP_COLORS</span></samp><dd><a
name="index-GREP_005fCOLORS-_0040r_007benvironment-variable_007d-131"></a><a
name="index-highlight-markers-132"></a>This variable specifies the colors and
other attributes
+ <br><dt><samp><span class="env">GREP_COLORS</span></samp><dd><a
name="index-GREP_005fCOLORS-_0040r_007benvironment-variable_007d-135"></a><a
name="index-highlight-markers-136"></a>This variable specifies the colors and
other attributes
used to highlight various parts of the output.
Its value is a colon-separated list of capabilities
that defaults to ‘<samp><span
class="samp">ms=01;31:mc=01;31:sl=:cx=:fn=35:ln=32:bn=32:se=36</span></samp>’
@@ -97,7 +97,7 @@
Supported capabilities are as follows.
<dl>
-<dt><code>sl=</code><dd><a
name="index-sl-GREP_005fCOLORS-_0040r_007bcapability_007d-133"></a>SGR
substring for whole selected lines
+<dt><code>sl=</code><dd><a
name="index-sl-GREP_005fCOLORS-_0040r_007bcapability_007d-137"></a>SGR
substring for whole selected lines
(i.e.,
matching lines when the ‘<samp><span
class="samp">-v</span></samp>’ command-line option is omitted,
or non-matching lines when ‘<samp><span
class="samp">-v</span></samp>’ is specified).
@@ -106,7 +106,7 @@
it applies to context matching lines instead.
The default is empty (i.e., the terminal's default color pair).
- <br><dt><code>cx=</code><dd><a
name="index-cx-GREP_005fCOLORS-_0040r_007bcapability_007d-134"></a>SGR
substring for whole context lines
+ <br><dt><code>cx=</code><dd><a
name="index-cx-GREP_005fCOLORS-_0040r_007bcapability_007d-138"></a>SGR
substring for whole context lines
(i.e.,
non-matching lines when the ‘<samp><span
class="samp">-v</span></samp>’ command-line option is omitted,
or matching lines when ‘<samp><span class="samp">-v</span></samp>’
is specified).
@@ -115,12 +115,12 @@
it applies to selected non-matching lines instead.
The default is empty (i.e., the terminal's default color pair).
- <br><dt><code>rv</code><dd><a
name="index-rv-GREP_005fCOLORS-_0040r_007bcapability_007d-135"></a>Boolean
value that reverses (swaps) the meanings of
+ <br><dt><code>rv</code><dd><a
name="index-rv-GREP_005fCOLORS-_0040r_007bcapability_007d-139"></a>Boolean
value that reverses (swaps) the meanings of
the ‘<samp><span class="samp">sl=</span></samp>’ and
‘<samp><span class="samp">cx=</span></samp>’ capabilities
when the ‘<samp><span class="samp">-v</span></samp>’ command-line
option is specified.
The default is false (i.e., the capability is omitted).
- <br><dt><code>mt=01;31</code><dd><a
name="index-mt-GREP_005fCOLORS-_0040r_007bcapability_007d-136"></a>SGR
substring for matching non-empty text in any matching line
+ <br><dt><code>mt=01;31</code><dd><a
name="index-mt-GREP_005fCOLORS-_0040r_007bcapability_007d-140"></a>SGR
substring for matching non-empty text in any matching line
(i.e.,
a selected line when the ‘<samp><span
class="samp">-v</span></samp>’ command-line option is omitted,
or a context line when ‘<samp><span class="samp">-v</span></samp>’
is specified).
@@ -128,35 +128,35 @@
at once to the same value.
The default is a bold red text foreground over the current line background.
- <br><dt><code>ms=01;31</code><dd><a
name="index-ms-GREP_005fCOLORS-_0040r_007bcapability_007d-137"></a>SGR
substring for matching non-empty text in a selected line.
+ <br><dt><code>ms=01;31</code><dd><a
name="index-ms-GREP_005fCOLORS-_0040r_007bcapability_007d-141"></a>SGR
substring for matching non-empty text in a selected line.
(This is only used when the ‘<samp><span
class="samp">-v</span></samp>’ command-line option is omitted.)
The effect of the ‘<samp><span class="samp">sl=</span></samp>’ (or
‘<samp><span class="samp">cx=</span></samp>’ if ‘<samp><span
class="samp">rv</span></samp>’) capability
remains active when this kicks in.
The default is a bold red text foreground over the current line background.
- <br><dt><code>mc=01;31</code><dd><a
name="index-mc-GREP_005fCOLORS-_0040r_007bcapability_007d-138"></a>SGR
substring for matching non-empty text in a context line.
+ <br><dt><code>mc=01;31</code><dd><a
name="index-mc-GREP_005fCOLORS-_0040r_007bcapability_007d-142"></a>SGR
substring for matching non-empty text in a context line.
(This is only used when the ‘<samp><span
class="samp">-v</span></samp>’ command-line option is specified.)
The effect of the ‘<samp><span class="samp">cx=</span></samp>’ (or
‘<samp><span class="samp">sl=</span></samp>’ if ‘<samp><span
class="samp">rv</span></samp>’) capability
remains active when this kicks in.
The default is a bold red text foreground over the current line background.
- <br><dt><code>fn=35</code><dd><a
name="index-fn-GREP_005fCOLORS-_0040r_007bcapability_007d-139"></a>SGR
substring for file names prefixing any content line.
+ <br><dt><code>fn=35</code><dd><a
name="index-fn-GREP_005fCOLORS-_0040r_007bcapability_007d-143"></a>SGR
substring for file names prefixing any content line.
The default is a magenta text foreground over the terminal's default
background.
- <br><dt><code>ln=32</code><dd><a
name="index-ln-GREP_005fCOLORS-_0040r_007bcapability_007d-140"></a>SGR
substring for line numbers prefixing any content line.
+ <br><dt><code>ln=32</code><dd><a
name="index-ln-GREP_005fCOLORS-_0040r_007bcapability_007d-144"></a>SGR
substring for line numbers prefixing any content line.
The default is a green text foreground over the terminal's default background.
- <br><dt><code>bn=32</code><dd><a
name="index-bn-GREP_005fCOLORS-_0040r_007bcapability_007d-141"></a>SGR
substring for byte offsets prefixing any content line.
+ <br><dt><code>bn=32</code><dd><a
name="index-bn-GREP_005fCOLORS-_0040r_007bcapability_007d-145"></a>SGR
substring for byte offsets prefixing any content line.
The default is a green text foreground over the terminal's default background.
- <br><dt><code>se=36</code><dd><a
name="index-fn-GREP_005fCOLORS-_0040r_007bcapability_007d-142"></a>SGR
substring for separators that are inserted
+ <br><dt><code>se=36</code><dd><a
name="index-fn-GREP_005fCOLORS-_0040r_007bcapability_007d-146"></a>SGR
substring for separators that are inserted
between selected line fields (‘<samp><span
class="samp">:</span></samp>’),
between context line fields (‘<samp><span
class="samp">-</span></samp>’),
and between groups of adjacent lines
when nonzero context is specified (‘<samp><span
class="samp">--</span></samp>’).
The default is a cyan text foreground over the terminal's default background.
- <br><dt><code>ne</code><dd><a
name="index-ne-GREP_005fCOLORS-_0040r_007bcapability_007d-143"></a>Boolean
value that prevents clearing to the end of line
+ <br><dt><code>ne</code><dd><a
name="index-ne-GREP_005fCOLORS-_0040r_007bcapability_007d-147"></a>Boolean
value that prevents clearing to the end of line
using Erase in Line (EL) to Right (‘<samp><span
class="samp">\33[K</span></samp>’)
each time a colorized item ends.
This is needed on terminals on which EL is not supported.
@@ -194,19 +194,19 @@
and ‘<samp><span class="samp">48;5;0</span></samp>’ to
‘<samp><span class="samp">48;5;255</span></samp>’
for 88-color and 256-color modes background colors.
- <br><dt><samp><span class="env">LC_ALL</span></samp><dt><samp><span
class="env">LC_COLLATE</span></samp><dt><samp><span
class="env">LANG</span></samp><dd><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-144"></a><a
name="index-LC_005fCOLLATE-_0040r_007benvironment-variable_007d-145"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-146"></a><a
name="index-character-type-147"></a><a
name="index-national-language-support-148"></a><a
name="index-NLS-149"></a>These variables specify the locale for the
<code>LC_COLLATE</code> category,
+ <br><dt><samp><span class="env">LC_ALL</span></samp><dt><samp><span
class="env">LC_COLLATE</span></samp><dt><samp><span
class="env">LANG</span></samp><dd><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-148"></a><a
name="index-LC_005fCOLLATE-_0040r_007benvironment-variable_007d-149"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-150"></a><a
name="index-character-type-151"></a><a
name="index-national-language-support-152"></a><a
name="index-NLS-153"></a>These variables specify the locale for the
<code>LC_COLLATE</code> category,
which determines the collating sequence
used to interpret range expressions like ‘<samp><span
class="samp">[a-z]</span></samp>’.
- <br><dt><samp><span class="env">LC_ALL</span></samp><dt><samp><span
class="env">LC_CTYPE</span></samp><dt><samp><span
class="env">LANG</span></samp><dd><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-150"></a><a
name="index-LC_005fCTYPE-_0040r_007benvironment-variable_007d-151"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-152"></a>These variables
specify the locale for the <code>LC_CTYPE</code> category,
+ <br><dt><samp><span class="env">LC_ALL</span></samp><dt><samp><span
class="env">LC_CTYPE</span></samp><dt><samp><span
class="env">LANG</span></samp><dd><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-154"></a><a
name="index-LC_005fCTYPE-_0040r_007benvironment-variable_007d-155"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-156"></a>These variables
specify the locale for the <code>LC_CTYPE</code> category,
which determines the type of characters,
e.g., which characters are whitespace.
- <br><dt><samp><span class="env">LC_ALL</span></samp><dt><samp><span
class="env">LC_MESSAGES</span></samp><dt><samp><span
class="env">LANG</span></samp><dd><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-153"></a><a
name="index-LC_005fMESSAGES-_0040r_007benvironment-variable_007d-154"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-155"></a><a
name="index-language-of-messages-156"></a><a
name="index-message-language-157"></a><a
name="index-national-language-support-158"></a><a
name="index-translation-of-message-language-159"></a>These variables specify
the locale for the <code>LC_MESSAGES</code> category,
+ <br><dt><samp><span class="env">LC_ALL</span></samp><dt><samp><span
class="env">LC_MESSAGES</span></samp><dt><samp><span
class="env">LANG</span></samp><dd><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-157"></a><a
name="index-LC_005fMESSAGES-_0040r_007benvironment-variable_007d-158"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-159"></a><a
name="index-language-of-messages-160"></a><a
name="index-message-language-161"></a><a
name="index-national-language-support-162"></a><a
name="index-translation-of-message-language-163"></a>These variables specify
the locale for the <code>LC_MESSAGES</code> category,
which determines the language that <samp><span
class="command">grep</span></samp> uses for messages.
The default ‘<samp><span class="samp">C</span></samp>’ locale uses
American English messages.
- <br><dt><samp><span class="env">POSIXLY_CORRECT</span></samp><dd><a
name="index-POSIXLY_005fCORRECT-_0040r_007benvironment-variable_007d-160"></a>If
set, <samp><span class="command">grep</span></samp> behaves as <span
class="sc">posix.2</span> requires; otherwise,
+ <br><dt><samp><span class="env">POSIXLY_CORRECT</span></samp><dd><a
name="index-POSIXLY_005fCORRECT-_0040r_007benvironment-variable_007d-164"></a>If
set, <samp><span class="command">grep</span></samp> behaves as <span
class="sc">posix.2</span> requires; otherwise,
<samp><span class="command">grep</span></samp> behaves more like other <span
class="sc">gnu</span> programs.
<span class="sc">posix.2</span>
requires that options that
@@ -221,7 +221,7 @@
<code>POSIXLY_CORRECT</code> also disables
<code>_</code><var>N</var><code>_GNU_nonoption_argv_flags_</code>,
described below.
- <br><dt><samp><span class="env">_</span><var>N</var><span
class="env">_GNU_nonoption_argv_flags_</span></samp><dd><a
name="index-g_t_005f_0040var_007bN_007d_005fGNU_005fnonoption_005fargv_005fflags_005f-_0040r_007benvironment-variable_007d-161"></a>(Here
<var>N</var> is <samp><span class="command">grep</span></samp>'s numeric
process ID.)
+ <br><dt><samp><span class="env">_</span><var>N</var><span
class="env">_GNU_nonoption_argv_flags_</span></samp><dd><a
name="index-g_t_005f_0040var_007bN_007d_005fGNU_005fnonoption_005fargv_005fflags_005f-_0040r_007benvironment-variable_007d-165"></a>(Here
<var>N</var> is <samp><span class="command">grep</span></samp>'s numeric
process ID.)
If the <var>i</var>th character of this environment variable's value is
‘<samp><span class="samp">1</span></samp>’,
do not consider the <var>i</var>th operand of <samp><span
class="command">grep</span></samp> to be an option,
even if it appears to be one.
- Changes to grep/manual/html_node/Environment-Variables.html,v,
Jim Meyering <=