[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: |
Fri, 05 Feb 2016 00:45:00 +0000 |
CVSROOT: /webcvs/grep
Module name: grep
Changes by: Jim Meyering <meyering> 16/02/05 00:44:53
Index: html_node/Environment-Variables.html
===================================================================
RCS file: /webcvs/grep/grep/manual/html_node/Environment-Variables.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -b -r1.21 -r1.22
--- html_node/Environment-Variables.html 2 Nov 2015 02:54:32 -0000
1.21
+++ html_node/Environment-Variables.html 5 Feb 2016 00:44:51 -0000
1.22
@@ -1,75 +1,101 @@
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- This manual is for grep, a pattern matching engine.
+
+Copyright (C) 1999-2002, 2005, 2008-2016 Free Software Foundation,
+Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
+Texts. A copy of the license is included in the section entitled
+"GNU Free Documentation License". -->
+<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>Environment Variables - GNU Grep 2.22</title>
+<title>GNU Grep 2.23: Environment Variables</title>
+
+<meta name="description" content="GNU Grep 2.23: Environment Variables">
+<meta name="keywords" content="GNU Grep 2.23: Environment Variables">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="description" content="GNU Grep 2.22">
-<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">
-<link rel="prev" href="Command_002dline-Options.html#Command_002dline-Options"
title="Command-line Options">
-<link rel="next" href="Exit-Status.html#Exit-Status" title="Exit Status">
-<link href="http://www.gnu.org/software/texinfo/"; rel="generator-home"
title="Texinfo Homepage">
+<link href="index.html#Top" rel="start" title="Top">
+<link href="Index.html#Index" rel="index" title="Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking.html#Invoking" rel="up" title="Invoking">
+<link href="Exit-Status.html#Exit-Status" rel="next" title="Exit Status">
+<link href="Other-Options.html#Other-Options" rel="prev" title="Other Options">
+<style type="text/css">
<!--
-This manual is for `grep', a pattern matching engine.
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space: nowrap}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: serif; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
-Copyright (C) 1999-2002, 2005, 2008-2015 Free Software Foundation,
-Inc.
- Permission is granted to copy, distribute and/or modify this
- document under the terms of the GNU Free Documentation License,
- Version 1.3 or any later version published by the Free Software
- Foundation; with no Invariant Sections, with no Front-Cover Texts,
- and with no Back-Cover Texts. A copy of the license is included
- in the section entitled ``GNU Free Documentation License''.
- -->
-<meta http-equiv="Content-Style-Type" content="text/css">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
-<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
</head>
-<body>
-<div class="node">
+
+<body lang="en">
<a name="Environment-Variables"></a>
+<div class="header">
<p>
-Next: <a rel="next" accesskey="n"
href="Exit-Status.html#Exit-Status">Exit Status</a>,
-Previous: <a rel="previous" accesskey="p"
href="Command_002dline-Options.html#Command_002dline-Options">Command-line
Options</a>,
-Up: <a rel="up" accesskey="u" href="Invoking.html#Invoking">Invoking</a>
-<hr>
+Next: <a href="Exit-Status.html#Exit-Status" accesskey="n" rel="next">Exit
Status</a>, Previous: <a
href="Command_002dline-Options.html#Command_002dline-Options" accesskey="p"
rel="prev">Command-line Options</a>, Up: <a href="Invoking.html#Invoking"
accesskey="u" rel="up">Invoking</a> [<a href="index.html#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a
href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
-
+<hr>
+<a name="Environment-Variables-1"></a>
<h3 class="section">2.2 Environment Variables</h3>
-<p>The behavior of <samp><span class="command">grep</span></samp> is affected
+<p>The behavior of <code>grep</code> is affected
by the following environment variables.
-
- <p><a name="index-LANGUAGE-_0040r_007benvironment-variable_007d-135"></a><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-136"></a><a
name="index-LC_005fMESSAGES-_0040r_007benvironment-variable_007d-137"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-138"></a>The locale for
category <code>LC_</code><var>foo</var><!-- /@w -->
+</p>
+<a name="index-LANGUAGE-environment-variable"></a>
+<a name="index-LC_005fALL-environment-variable"></a>
+<a name="index-LC_005fMESSAGES-environment-variable"></a>
+<a name="index-LANG-environment-variable"></a>
+<p>The locale for category <code><span
class="nolinebreak">LC_</span><var>foo</var></code><!-- /@w -->
is specified by examining the three environment variables
-<samp><span class="env">LC_ALL</span></samp>, <samp><span
class="env">LC_</span><var>foo</var></samp><!-- /@w -->, and <samp><span
class="env">LANG</span></samp>,
+<code>LC_ALL</code>, <code><span
class="nolinebreak">LC_</span><var>foo</var></code><!-- /@w -->, and
<code>LANG</code>,
in that order.
The first of these variables that is set specifies the locale.
-For example, if <samp><span class="env">LC_ALL</span></samp> is not set,
-but <samp><span class="env">LC_COLLATE</span></samp> is set to
‘<samp><span class="samp">pt_BR</span></samp>’,
+For example, if <code>LC_ALL</code> is not set,
+but <code>LC_COLLATE</code> is set to ‘<samp>pt_BR</samp>’,
then the Brazilian Portuguese locale is used
-for the <samp><span class="env">LC_COLLATE</span></samp> category.
-As a special case for <samp><span class="env">LC_MESSAGES</span></samp> only,
the environment variable
-<samp><span class="env">LANGUAGE</span></samp> can contain a colon-separated
list of languages that
+for the <code>LC_COLLATE</code> category.
+As a special case for <code>LC_MESSAGES</code> only, the environment variable
+<code>LANGUAGE</code> can contain a colon-separated list of languages that
overrides the three environment variables that ordinarily specify
-the <samp><span class="env">LC_MESSAGES</span></samp> category.
-The ‘<samp><span class="samp">C</span></samp>’ locale is used if
none of these environment variables are set,
+the <code>LC_MESSAGES</code> category.
+The ‘<samp>C</samp>’ locale is used if none of these environment
variables are set,
if the locale catalog is not installed,
-or if <samp><span class="command">grep</span></samp> was not compiled
+or if <code>grep</code> was not compiled
with national language support (NLS).
-
- <p>Many of the environment variables in the following list let you
+</p>
+<p>Many of the environment variables in the following list let you
control highlighting using
Select Graphic Rendition (SGR)
commands interpreted by the terminal or terminal emulator.
@@ -79,125 +105,171 @@
for permitted values and their meanings as character attributes.)
These substring values are integers in decimal representation
and can be concatenated with semicolons.
-<samp><span class="command">grep</span></samp> takes care of assembling the
result
-into a complete SGR sequence (‘<samp><span
class="samp">\33[</span></samp>’...‘<samp><span
class="samp">m</span></samp>’).
+<code>grep</code> takes care of assembling the result
+into a complete SGR sequence
(‘<samp>\33[</samp>’...‘<samp>m</samp>’).
Common values to concatenate include
-‘<samp><span class="samp">1</span></samp>’ for bold,
-‘<samp><span class="samp">4</span></samp>’ for underline,
-‘<samp><span class="samp">5</span></samp>’ for blink,
-‘<samp><span class="samp">7</span></samp>’ for inverse,
-‘<samp><span class="samp">39</span></samp>’ for default foreground
color,
-‘<samp><span class="samp">30</span></samp>’ to ‘<samp><span
class="samp">37</span></samp>’ for foreground colors,
-‘<samp><span class="samp">90</span></samp>’ to ‘<samp><span
class="samp">97</span></samp>’ for 16-color mode foreground colors,
-‘<samp><span class="samp">38;5;0</span></samp>’ to
‘<samp><span class="samp">38;5;255</span></samp>’
+‘<samp>1</samp>’ for bold,
+‘<samp>4</samp>’ for underline,
+‘<samp>5</samp>’ for blink,
+‘<samp>7</samp>’ for inverse,
+‘<samp>39</samp>’ for default foreground color,
+‘<samp>30</samp>’ to ‘<samp>37</samp>’ for foreground
colors,
+‘<samp>90</samp>’ to ‘<samp>97</samp>’ for 16-color
mode foreground colors,
+‘<samp>38;5;0</samp>’ to ‘<samp>38;5;255</samp>’
for 88-color and 256-color modes foreground colors,
-‘<samp><span class="samp">49</span></samp>’ for default background
color,
-‘<samp><span class="samp">40</span></samp>’ to ‘<samp><span
class="samp">47</span></samp>’ for background colors,
-‘<samp><span class="samp">100</span></samp>’ to ‘<samp><span
class="samp">107</span></samp>’ for 16-color mode background colors,
-and ‘<samp><span class="samp">48;5;0</span></samp>’ to
‘<samp><span class="samp">48;5;255</span></samp>’
+‘<samp>49</samp>’ for default background color,
+‘<samp>40</samp>’ to ‘<samp>47</samp>’ for background
colors,
+‘<samp>100</samp>’ to ‘<samp>107</samp>’ for 16-color
mode background colors,
+and ‘<samp>48;5;0</samp>’ to ‘<samp>48;5;255</samp>’
for 88-color and 256-color modes background colors.
-
- <p>The two-letter names used in the <samp><span
class="env">GREP_COLORS</span></samp> environment variable
+</p>
+<p>The two-letter names used in the <code>GREP_COLORS</code> environment
variable
(and some of the others) refer to terminal “capabilities,” the
ability
of a terminal to highlight text, or change its color, and so on.
These capabilities are stored in an online database and accessed by
the <code>terminfo</code> library.
+</p>
+<a name="index-environment-variables"></a>
- <p><a name="index-environment-variables-139"></a>
- <dl>
-<dt><samp><span class="env">GREP_OPTIONS</span></samp><dd><a
name="index-GREP_005fOPTIONS-_0040r_007benvironment-variable_007d-140"></a><a
name="index-default-options-environment-variable-141"></a>This variable
specifies default options to be placed in front of any
+<dl compact="compact">
+<dt><code>GREP_OPTIONS</code></dt>
+<dd><a name="index-GREP_005fOPTIONS-environment-variable"></a>
+<a name="index-default-options-environment-variable"></a>
+<p>This variable specifies default options to be placed in front of any
explicit options.
As this causes problems when writing portable scripts, this feature
-will be removed in a future release of <samp><span
class="command">grep</span></samp>, and <samp><span
class="command">grep</span></samp>
+will be removed in a future release of <code>grep</code>, and <code>grep</code>
warns if it is used. Please use an alias or script instead.
-For example, if <samp><span class="command">grep</span></samp> is in the
directory ‘<samp><span class="samp">/usr/bin</span></samp>’ you
-can prepend <samp><span class="file">$HOME/bin</span></samp> to your
<samp><span class="env">PATH</span></samp> and create an
-executable script <samp><span class="file">$HOME/bin/grep</span></samp>
containing the following:
-
- <pre class="example"> #! /bin/sh
- export PATH=/usr/bin
- exec grep --color=auto --devices=skip "$@"
-</pre>
- <br><dt><samp><span class="env">GREP_COLOR</span></samp><dd><a
name="index-GREP_005fCOLOR-_0040r_007benvironment-variable_007d-142"></a><a
name="index-highlight-markers-143"></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>
+For example, if <code>grep</code> is in the directory
‘<samp>/usr/bin</samp>’ you
+can prepend <samp>$HOME/bin</samp> to your <code>PATH</code> and create an
+executable script <samp>$HOME/bin/grep</samp> containing the following:
+</p>
+<div class="example">
+<pre class="example">#! /bin/sh
+export PATH=/usr/bin
+exec grep --color=auto --devices=skip "$@"
+</pre></div>
+
+</dd>
+<dt><code>GREP_COLOR</code></dt>
+<dd><a name="index-GREP_005fCOLOR-environment-variable"></a>
+<a name="index-highlight-markers"></a>
+<p>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>mt</samp>’, ‘<samp>ms</samp>’, and
‘<samp>mc</samp>’ capabilities of <code>GREP_COLORS</code>
have priority over it.
It can only specify the color used to highlight
the matching non-empty text in any matching line
-(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).
-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-144"></a><a
name="index-highlight-markers-145"></a>This variable specifies the colors and
other attributes
+(a selected line when the <samp>-v</samp> command-line option is omitted,
+or a context line when <samp>-v</samp> is specified).
+The default is ‘<samp>01;31</samp>’,
+which means a bold red foreground text on the terminal’s default
background.
+</p>
+</dd>
+<dt><code>GREP_COLORS</code></dt>
+<dd><a name="index-GREP_005fCOLORS-environment-variable"></a>
+<a name="index-highlight-markers-1"></a>
+<p>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>’
-with the ‘<samp><span class="samp">rv</span></samp>’ and
‘<samp><span class="samp">ne</span></samp>’ boolean capabilities
omitted (i.e., false).
+that defaults to
‘<samp>ms=01;31:mc=01;31:sl=:cx=:fn=35:ln=32:bn=32:se=36</samp>’
+with the ‘<samp>rv</samp>’ and ‘<samp>ne</samp>’
boolean capabilities omitted (i.e., false).
Supported capabilities are as follows.
-
- <dl>
-<dt><code>sl=</code><dd><a
name="index-sl-GREP_005fCOLORS-_0040r_007bcapability_007d-146"></a>SGR
substring for whole selected lines
+</p>
+<dl compact="compact">
+<dt><code>sl=</code></dt>
+<dd><a name="index-sl-GREP_005fCOLORS-capability"></a>
+<p>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).
-If however the boolean ‘<samp><span class="samp">rv</span></samp>’
capability
-and the <samp><span class="option">-v</span></samp> command-line option are
both specified,
+matching lines when the <samp>-v</samp> command-line option is omitted,
+or non-matching lines when <samp>-v</samp> is specified).
+If however the boolean ‘<samp>rv</samp>’ capability
+and the <samp>-v</samp> command-line option are both specified,
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-147"></a>SGR
substring for whole context lines
+The default is empty (i.e., the terminal’s default color pair).
+</p>
+</dd>
+<dt><code>cx=</code></dt>
+<dd><a name="index-cx-GREP_005fCOLORS-capability"></a>
+<p>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).
-If however the boolean ‘<samp><span class="samp">rv</span></samp>’
capability
-and the <samp><span class="option">-v</span></samp> command-line option are
both specified,
+non-matching lines when the <samp>-v</samp> command-line option is omitted,
+or matching lines when <samp>-v</samp> is specified).
+If however the boolean ‘<samp>rv</samp>’ capability
+and the <samp>-v</samp> command-line option are both specified,
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-148"></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 empty (i.e., the terminal’s default color pair).
+</p>
+</dd>
+<dt><code>rv</code></dt>
+<dd><a name="index-rv-GREP_005fCOLORS-capability"></a>
+<p>Boolean value that reverses (swaps) the meanings of
+the ‘<samp>sl=</samp>’ and ‘<samp>cx=</samp>’
capabilities
+when the <samp>-v</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-149"></a>SGR
substring for matching non-empty text in any matching line
+</p>
+</dd>
+<dt><code>mt=01;31</code></dt>
+<dd><a name="index-mt-GREP_005fCOLORS-capability"></a>
+<p>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).
-Setting this is equivalent to setting both ‘<samp><span
class="samp">ms=</span></samp>’ and ‘<samp><span
class="samp">mc=</span></samp>’
+a selected line when the <samp>-v</samp> command-line option is omitted,
+or a context line when <samp>-v</samp> is specified).
+Setting this is equivalent to setting both ‘<samp>ms=</samp>’ and
‘<samp>mc=</samp>’
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-150"></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
+</p>
+</dd>
+<dt><code>ms=01;31</code></dt>
+<dd><a name="index-ms-GREP_005fCOLORS-capability"></a>
+<p>SGR substring for matching non-empty text in a selected line.
+(This is used only when the <samp>-v</samp> command-line option is omitted.)
+The effect of the ‘<samp>sl=</samp>’ (or
‘<samp>cx=</samp>’ if ‘<samp>rv</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-151"></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
+</p>
+</dd>
+<dt><code>mc=01;31</code></dt>
+<dd><a name="index-mc-GREP_005fCOLORS-capability"></a>
+<p>SGR substring for matching non-empty text in a context line.
+(This is used only when the <samp>-v</samp> command-line option is specified.)
+The effect of the ‘<samp>cx=</samp>’ (or
‘<samp>sl=</samp>’ if ‘<samp>rv</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-152"></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-153"></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-154"></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-155"></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>’),
+</p>
+</dd>
+<dt><code>fn=35</code></dt>
+<dd><a name="index-fn-GREP_005fCOLORS-capability"></a>
+<p>SGR substring for file names prefixing any content line.
+The default is a magenta text foreground over the terminal’s default
background.
+</p>
+</dd>
+<dt><code>ln=32</code></dt>
+<dd><a name="index-ln-GREP_005fCOLORS-capability"></a>
+<p>SGR substring for line numbers prefixing any content line.
+The default is a green text foreground over the terminal’s default
background.
+</p>
+</dd>
+<dt><code>bn=32</code></dt>
+<dd><a name="index-bn-GREP_005fCOLORS-capability"></a>
+<p>SGR substring for byte offsets prefixing any content line.
+The default is a green text foreground over the terminal’s default
background.
+</p>
+</dd>
+<dt><code>se=36</code></dt>
+<dd><a name="index-fn-GREP_005fCOLORS-capability-1"></a>
+<p>SGR substring for separators that are inserted
+between selected line fields (‘<samp>:</samp>’),
+between context line fields (‘<samp>-</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-156"></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>’)
+when nonzero context is specified (‘<samp>--</samp>’).
+The default is a cyan text foreground over the terminal’s default
background.
+</p>
+</dd>
+<dt><code>ne</code></dt>
+<dd><a name="index-ne-GREP_005fCOLORS-capability"></a>
+<p>Boolean value that prevents clearing to the end of line
+using Erase in Line (EL) to Right (‘<samp>\33[K</samp>’)
each time a colorized item ends.
This is needed on terminals on which EL is not supported.
It is otherwise useful on terminals
@@ -206,45 +278,93 @@
when the chosen highlight colors do not affect the background,
or when EL is too slow or causes too much flicker.
The default is false (i.e., the capability is omitted).
+</p></dd>
</dl>
- <p>Note that boolean capabilities have no ‘<samp><span
class="samp">=</span></samp>’... part.
+<p>Note that boolean capabilities have no ‘<samp>=</samp>’... part.
They are omitted (i.e., false) by default and become true when specified.
+</p>
- <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-157"></a><a
name="index-LC_005fCOLLATE-_0040r_007benvironment-variable_007d-158"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-159"></a><a
name="index-character-type-160"></a><a
name="index-national-language-support-161"></a><a
name="index-NLS-162"></a>These variables specify the locale for the <samp><span
class="env">LC_COLLATE</span></samp> category,
-which might affect how range expressions like ‘<samp><span
class="samp">[a-z]</span></samp>’ are
+</dd>
+<dt><code>LC_ALL</code></dt>
+<dt><code>LC_COLLATE</code></dt>
+<dt><code>LANG</code></dt>
+<dd><a name="index-LC_005fALL-environment-variable-1"></a>
+<a name="index-LC_005fCOLLATE-environment-variable"></a>
+<a name="index-LANG-environment-variable-1"></a>
+<a name="index-character-type"></a>
+<a name="index-national-language-support"></a>
+<a name="index-NLS"></a>
+<p>These variables specify the locale for the <code>LC_COLLATE</code> category,
+which might affect how range expressions like ‘<samp>[a-z]</samp>’
are
interpreted.
-
- <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-163"></a><a
name="index-LC_005fCTYPE-_0040r_007benvironment-variable_007d-164"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-165"></a>These variables
specify the locale for the <samp><span class="env">LC_CTYPE</span></samp>
category,
+</p>
+</dd>
+<dt><code>LC_ALL</code></dt>
+<dt><code>LC_CTYPE</code></dt>
+<dt><code>LANG</code></dt>
+<dd><a name="index-LC_005fALL-environment-variable-2"></a>
+<a name="index-LC_005fCTYPE-environment-variable"></a>
+<a name="index-LANG-environment-variable-2"></a>
+<p>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">LANGUAGE</span></samp><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-LANGUAGE-_0040r_007benvironment-variable_007d-166"></a><a
name="index-LC_005fALL-_0040r_007benvironment-variable_007d-167"></a><a
name="index-LC_005fMESSAGES-_0040r_007benvironment-variable_007d-168"></a><a
name="index-LANG-_0040r_007benvironment-variable_007d-169"></a><a
name="index-language-of-messages-170"></a><a
name="index-message-language-171"></a><a
name="index-national-language-support-172"></a><a
name="index-translation-of-message-language-173"></a>These variables specify
the locale for the <samp><span class="env">LC_MESSAGES</span></samp> 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-174"></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.
+</p>
+</dd>
+<dt><code>LANGUAGE</code></dt>
+<dt><code>LC_ALL</code></dt>
+<dt><code>LC_MESSAGES</code></dt>
+<dt><code>LANG</code></dt>
+<dd><a name="index-LANGUAGE-environment-variable-1"></a>
+<a name="index-LC_005fALL-environment-variable-3"></a>
+<a name="index-LC_005fMESSAGES-environment-variable-1"></a>
+<a name="index-LANG-environment-variable-3"></a>
+<a name="index-language-of-messages"></a>
+<a name="index-message-language"></a>
+<a name="index-national-language-support-1"></a>
+<a name="index-translation-of-message-language"></a>
+<p>These variables specify the locale for the <code>LC_MESSAGES</code>
category,
+which determines the language that <code>grep</code> uses for messages.
+The default ‘<samp>C</samp>’ locale uses American English messages.
+</p>
+</dd>
+<dt><code>POSIXLY_CORRECT</code></dt>
+<dd><a name="index-POSIXLY_005fCORRECT-environment-variable"></a>
+<p>If set, <code>grep</code> behaves as POSIX requires; otherwise,
+<code>grep</code> behaves more like other GNU programs.
POSIX
requires that options that
follow file names must be treated as file names;
by default,
such options are permuted to the front of the operand list
and are treated as options.
-Also, <samp><span class="env">POSIXLY_CORRECT</span></samp> 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-175"></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,
+Also, <code>POSIXLY_CORRECT</code> disables special handling of an
+invalid bracket expression. See <a
href="Character-Classes-and-Bracket-Expressions.html#invalid_002dbracket_002dexpr">invalid-bracket-expr</a>.
+</p>
+</dd>
+<dt><code>_<var>N</var>_GNU_nonoption_argv_flags_</code></dt>
+<dd><a
name="index-_005fN_005fGNU_005fnonoption_005fargv_005fflags_005f-environment-variable"></a>
+<p>(Here <code><var>N</var></code> is <code>grep</code>’s numeric
process ID.)
+If the <var>i</var>th character of this environment variable’s value is
‘<samp>1</samp>’,
+do not consider the <var>i</var>th operand of <code>grep</code> to be an
option,
even if it appears to be one.
A shell can put this variable in the environment for each command it runs,
specifying which operands are the results of file name wildcard expansion
and therefore should not be treated as options.
This behavior is available only with the GNU C library,
-and only when <samp><span class="env">POSIXLY_CORRECT</span></samp> is not set.
+and only when <code>POSIXLY_CORRECT</code> is not set.
+</p>
+</dd>
+</dl>
+
+
+<hr>
+<div class="header">
+<p>
+Next: <a href="Exit-Status.html#Exit-Status" accesskey="n" rel="next">Exit
Status</a>, Previous: <a
href="Command_002dline-Options.html#Command_002dline-Options" accesskey="p"
rel="prev">Command-line Options</a>, Up: <a href="Invoking.html#Invoking"
accesskey="u" rel="up">Invoking</a> [<a href="index.html#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a
href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
+</div>
- </dl>
- </body></html>
+</body>
+</html>
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- Changes to grep/manual/html_node/Environment-Variables.html,v,
Jim Meyering <=