[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Changes to manual/html_node/General-Output-Control.html
|
From: |
Karl Berry |
|
Subject: |
Changes to manual/html_node/General-Output-Control.html |
|
Date: |
Sun, 24 May 2009 18:43:08 +0000 |
CVSROOT: /web/grep
Module name: grep
Changes by: Karl Berry <karl> 09/05/24 18:43:01
Index: manual/html_node/General-Output-Control.html
===================================================================
RCS file: manual/html_node/General-Output-Control.html
diff -N manual/html_node/General-Output-Control.html
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ manual/html_node/General-Output-Control.html 24 May 2009 18:42:59
-0000 1.1
@@ -0,0 +1,141 @@
+<html lang="en">
+<head>
+<title>General Output Control - GNU Grep 2.5.4</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="GNU Grep 2.5.4">
+<meta name="generator" content="makeinfo 4.13">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="Command_002dline-Options.html#Command_002dline-Options"
title="Command-line Options">
+<link rel="prev" href="Matching-Control.html#Matching-Control" title="Matching
Control">
+<link rel="next"
href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control" title="Output
Line Prefix Control">
+<link href="http://www.gnu.org/software/texinfo/"; rel="generator-home"
title="Texinfo Homepage">
+<!--
+This manual is for `grep', a pattern matching engine.
+
+Copyright (C) 1999, 2000, 2001, 2002, 2005, 2008, 2009 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>
+</head>
+<body>
+<div class="node">
+<a name="General-Output-Control"></a>
+<p>
+Next: <a rel="next" accesskey="n"
href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control">Output Line
Prefix Control</a>,
+Previous: <a rel="previous" accesskey="p"
href="Matching-Control.html#Matching-Control">Matching Control</a>,
+Up: <a rel="up" accesskey="u"
href="Command_002dline-Options.html#Command_002dline-Options">Command-line
Options</a>
+<hr>
+</div>
+
+<h4 class="subsection">2.1.3 General Output Control</h4>
+
+ <dl>
+<dt>‘<samp><span
class="samp">-c</span></samp>’<dt>‘<samp><span
class="samp">--count</span></samp>’<dd><a
name="index-g_t_002dc-27"></a><a name="index-g_t_002d_002dcount-28"></a><a
name="index-counting-lines-29"></a>Suppress normal output;
+instead print a count of matching lines for each input file.
+With the ‘<samp><span class="samp">-v</span></samp>’,
‘<samp><span class="samp">--invert-match</span></samp>’ option,
+count non-matching lines.
+(‘<samp><span class="samp">-c</span></samp>’ is specified by <span
class="sc">posix</span>.)
+
+ <br><dt>‘<samp><span
class="samp">--color[=</span><var>WHEN</var><span
class="samp">]</span></samp>’<dt>‘<samp><span
class="samp">--colour[=</span><var>WHEN</var><span
class="samp">]</span></samp>’<dd><a
name="index-g_t_002d_002dcolor-30"></a><a
name="index-g_t_002d_002dcolour-31"></a><a
name="index-highlight_002c-color_002c-colour-32"></a>Surround the matched
(non-empty) strings, matching lines, context lines,
+file names, line numbers, byte 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 <var>GREP_COLORS</var>
+and default to ‘<samp><span
class="samp">ms=01;31:mc=01;31:sl=:cx=:fn=35:ln=32:bn=32:se=36</span></samp>’
+for bold red matched text, magenta file names, green line numbers,
+green byte offsets, cyan separators, and default terminal colors otherwise.
+The deprecated environment variable <var>GREP_COLOR</var> 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.
+<var>WHEN</var> is ‘<samp><span class="samp">never</span></samp>’,
‘<samp><span class="samp">always</span></samp>’, or
‘<samp><span class="samp">auto</span></samp>’.
+
+ <br><dt>‘<samp><span
class="samp">-L</span></samp>’<dt>‘<samp><span
class="samp">--files-without-match</span></samp>’<dd><a
name="index-g_t_002dL-33"></a><a
name="index-g_t_002d_002dfiles_002dwithout_002dmatch-34"></a><a
name="index-files-which-don_0027t-match-35"></a>Suppress normal output;
+instead print the name of each input file from which
+no output would normally have been printed.
+The scanning of every file will stop on the first match.
+
+ <br><dt>‘<samp><span
class="samp">-l</span></samp>’<dt>‘<samp><span
class="samp">--files-with-matches</span></samp>’<dd><a
name="index-g_t_002dl-36"></a><a
name="index-g_t_002d_002dfiles_002dwith_002dmatches-37"></a><a
name="index-names-of-matching-files-38"></a>Suppress normal output;
+instead print the name of each input file from which
+output would normally have been printed.
+The scanning of every file will stop on the first match.
+(‘<samp><span class="samp">-l</span></samp>’ is specified by <span
class="sc">posix</span>.)
+
+ <br><dt>‘<samp><span class="samp">-m
</span><var>num</var></samp>’<dt>‘<samp><span
class="samp">--max-count=</span><var>num</var></samp>’<dd><a
name="index-g_t_002dm-39"></a><a
name="index-g_t_002d_002dmax_002dcount-40"></a><a
name="index-max_002dcount-41"></a>Stop reading a file after <var>num</var>
matching lines.
+If the input is standard input from a regular file,
+and <var>num</var> matching lines are output,
+<samp><span class="command">grep</span></samp> ensures that the standard input
is positioned
+just after the last matching line before exiting,
+regardless of the presence of trailing context lines.
+This enables a calling process to resume a search.
+For example, the following shell script makes use of it:
+
+ <pre class="example"> while grep -m 1 PATTERN
+ do
+ echo xxxx
+ done < FILE
+</pre>
+ <p>But the following probably will not work because a pipe is not a
regular
+file:
+
+ <pre class="example"> # This probably will not work.
+ cat FILE |
+ while grep -m 1 PATTERN
+ do
+ echo xxxx
+ done
+</pre>
+ <p>When <samp><span class="command">grep</span></samp> stops after
<var>num</var> matching lines,
+it outputs any trailing context lines.
+Since context does not include matching lines,
+<samp><span class="command">grep</span></samp> will stop when it encounters
another matching line.
+When the ‘<samp><span class="samp">-c</span></samp>’ or
‘<samp><span class="samp">--count</span></samp>’ option is also
used,
+<samp><span class="command">grep</span></samp> does not output a count greater
than <var>num</var>.
+When the ‘<samp><span class="samp">-v</span></samp>’ or
‘<samp><span class="samp">--invert-match</span></samp>’ option is
also used,
+<samp><span class="command">grep</span></samp> stops after outputting
<var>num</var> non-matching lines.
+
+ <br><dt>‘<samp><span
class="samp">-o</span></samp>’<dt>‘<samp><span
class="samp">--only-matching</span></samp>’<dd><a
name="index-g_t_002do-42"></a><a
name="index-g_t_002d_002donly_002dmatching-43"></a><a
name="index-only-matching-44"></a>Print only the matched (non-empty) parts of
matching lines,
+with each such part on a separate output line.
+
+ <br><dt>‘<samp><span
class="samp">-q</span></samp>’<dt>‘<samp><span
class="samp">--quiet</span></samp>’<dt>‘<samp><span
class="samp">--silent</span></samp>’<dd><a
name="index-g_t_002dq-45"></a><a name="index-g_t_002d_002dquiet-46"></a><a
name="index-g_t_002d_002dsilent-47"></a><a
name="index-quiet_002c-silent-48"></a>Quiet; do not write anything to standard
output.
+Exit immediately with zero status if any match is found,
+even if an error was detected.
+Also see the ‘<samp><span class="samp">-s</span></samp>’ or
‘<samp><span class="samp">--no-messages</span></samp>’ option.
+(‘<samp><span class="samp">-q</span></samp>’ is specified by <span
class="sc">posix</span>.)
+
+ <br><dt>‘<samp><span
class="samp">-s</span></samp>’<dt>‘<samp><span
class="samp">--no-messages</span></samp>’<dd><a
name="index-g_t_002ds-49"></a><a
name="index-g_t_002d_002dno_002dmessages-50"></a><a
name="index-suppress-error-messages-51"></a>Suppress error messages about
nonexistent or unreadable files.
+Portability note:
+unlike <span class="sc">gnu</span> <samp><span
class="command">grep</span></samp>,
+7th Edition Unix <samp><span class="command">grep</span></samp> did not
conform to <span class="sc">posix</span>,
+because it lacked ‘<samp><span class="samp">-q</span></samp>’
+and its ‘<samp><span class="samp">-s</span></samp>’ option behaved
like
+<span class="sc">gnu</span> <samp><span class="command">grep</span></samp>'s
‘<samp><span class="samp">-q</span></samp>’ option.
+<span class="sc">usg</span>-style <samp><span
class="command">grep</span></samp> also lacked ‘<samp><span
class="samp">-q</span></samp>’
+but its ‘<samp><span class="samp">-s</span></samp>’ option behaved
like <span class="sc">gnu</span> <samp><span
class="command">grep</span></samp>'s.
+Portable shell scripts should avoid both
+‘<samp><span class="samp">-q</span></samp>’ and ‘<samp><span
class="samp">-s</span></samp>’ and should redirect
+standard and error output to <samp><span class="file">/dev/null</span></samp>
instead.
+(‘<samp><span class="samp">-s</span></samp>’ is specified by <span
class="sc">posix</span>.)
+
+</dl>
+
+ </body></html>
+
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- Changes to manual/html_node/General-Output-Control.html,
Karl Berry <=