[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, 24 Apr 2012 08:04:09 +0000 |
CVSROOT: /webcvs/grep
Module name: grep
Changes by: Jim Meyering <meyering> 12/04/24 08:04:00
Index: html_node/Environment-Variables.html
===================================================================
RCS file: /webcvs/grep/grep/manual/html_node/Environment-Variables.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- html_node/Environment-Variables.html 2 Mar 2012 09:28:27 -0000
1.10
+++ html_node/Environment-Variables.html 24 Apr 2012 08:03:55 -0000
1.11
@@ -1,8 +1,8 @@
<html lang="en">
<head>
-<title>Environment Variables - GNU Grep 2.11</title>
+<title>Environment Variables - GNU Grep 2.12</title>
<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="GNU Grep 2.11">
+<meta name="description" content="GNU Grep 2.12">
<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">
@@ -98,9 +98,9 @@
These capabilities are stored in an online database and accessed by
the <code>terminfo</code> library.
- <p><a name="index-environment-variables-130"></a>
+ <p><a name="index-environment-variables-137"></a>
<dl>
-<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
+<dt><samp><span class="env">GREP_OPTIONS</span></samp><dd><a
name="index-GREP_005fOPTIONS-_0040r_007benvironment-variable_007d-138"></a><a
name="index-default-options-environment-variable-139"></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>
@@ -119,7 +119,7 @@
command ‘<samp><span class="samp">grep -r PAT</span></samp>’
searches the working directory, regardless
of whether <code>GREP_OPTIONS</code> contains <samp><span
class="option">-r</span></samp>.
- <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.
+ <br><dt><samp><span class="env">GREP_COLOR</span></samp><dd><a
name="index-GREP_005fCOLOR-_0040r_007benvironment-variable_007d-140"></a><a
name="index-highlight-markers-141"></a>This variable specifies the color used
to highlight matched (non-empty) text.
It is deprecated in favor of <samp><span
class="env">GREP_COLORS</span></samp>, 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 <samp><span
class="env">GREP_COLORS</span></samp>
have priority over it.
@@ -130,7 +130,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-135"></a><a
name="index-highlight-markers-136"></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-142"></a><a
name="index-highlight-markers-143"></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 <code>terminfo</code> 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>’
@@ -138,7 +138,7 @@
Supported capabilities are as follows.
<dl>
-<dt><code>sl=</code><dd><a
name="index-sl-GREP_005fCOLORS-_0040r_007bcapability_007d-137"></a>SGR
substring for whole selected lines
+<dt><code>sl=</code><dd><a
name="index-sl-GREP_005fCOLORS-_0040r_007bcapability_007d-144"></a>SGR
substring for whole selected lines
(i.e.,
matching lines when the <samp><span class="option">-v</span></samp>
command-line option is omitted,
or non-matching lines when <samp><span class="option">-v</span></samp> is
specified).
@@ -147,7 +147,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-138"></a>SGR
substring for whole context lines
+ <br><dt><code>cx=</code><dd><a
name="index-cx-GREP_005fCOLORS-_0040r_007bcapability_007d-145"></a>SGR
substring for whole context lines
(i.e.,
non-matching lines when the <samp><span class="option">-v</span></samp>
command-line option is omitted,
or matching lines when <samp><span class="option">-v</span></samp> is
specified).
@@ -156,12 +156,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-139"></a>Boolean
value that reverses (swaps) the meanings of
+ <br><dt><code>rv</code><dd><a
name="index-rv-GREP_005fCOLORS-_0040r_007bcapability_007d-146"></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="option">-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-140"></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-147"></a>SGR
substring for matching non-empty text in any matching line
(i.e.,
a selected line when the <samp><span class="option">-v</span></samp>
command-line option is omitted,
or a context line when <samp><span class="option">-v</span></samp> is
specified).
@@ -169,35 +169,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-141"></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-148"></a>SGR
substring for matching non-empty text in a selected line.
(This is used only when the <samp><span class="option">-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 takes effect.
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-142"></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-149"></a>SGR
substring for matching non-empty text in a context line.
(This is used only when the <samp><span class="option">-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 takes effect.
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-143"></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-150"></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-144"></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-151"></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-145"></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-152"></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-146"></a>SGR
substring for separators that are inserted
+ <br><dt><code>se=36</code><dd><a
name="index-fn-GREP_005fCOLORS-_0040r_007bcapability_007d-153"></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-147"></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-154"></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.
@@ -212,19 +212,19 @@
<p>Note that boolean capabilities have no ‘<samp><span
class="samp">=</span></samp>’... part.
They are omitted (i.e., false) by default and become true when specified.
- <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,
+ <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-155"></a><a
name="index-LC_005fCOLLATE-_0040r_007benvironment-variable_007d-156"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-157"></a><a
name="index-character-type-158"></a><a
name="index-national-language-support-159"></a><a
name="index-NLS-160"></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-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,
+ <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-161"></a><a
name="index-LC_005fCTYPE-_0040r_007benvironment-variable_007d-162"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-163"></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-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,
+ <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-164"></a><a
name="index-LC_005fMESSAGES-_0040r_007benvironment-variable_007d-165"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-166"></a><a
name="index-language-of-messages-167"></a><a
name="index-message-language-168"></a><a
name="index-national-language-support-169"></a><a
name="index-translation-of-message-language-170"></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-164"></a>If
set, <samp><span class="command">grep</span></samp> behaves as POSIX requires;
otherwise,
+ <br><dt><samp><span class="env">POSIXLY_CORRECT</span></samp><dd><a
name="index-POSIXLY_005fCORRECT-_0040r_007benvironment-variable_007d-171"></a>If
set, <samp><span class="command">grep</span></samp> behaves as POSIX requires;
otherwise,
<samp><span class="command">grep</span></samp> behaves more like other GNU
programs.
POSIX
requires that options that
@@ -235,7 +235,7 @@
Also, <code>POSIXLY_CORRECT</code> disables special handling of an
invalid bracket expression. See <a
href="invalid_002dbracket_002dexpr.html#invalid_002dbracket_002dexpr">invalid-bracket-expr</a>.
- <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.)
+ <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-172"></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.
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- Changes to grep/manual/html_node/Environment-Variables.html,v,
Jim Meyering <=