CVSROOT: /webcvs/grep Module name: grep Changes by: Jim Meyering <meyering> 21/08/14 16:46:41
Index: html_node/General-Output-Control.html =================================================================== RCS file: /webcvs/grep/grep/manual/html_node/General-Output-Control.html,v retrieving revision 1.31 retrieving revision 1.32 diff -u -b -r1.31 -r1.32 --- html_node/General-Output-Control.html 28 Sep 2020 03:36:49 -0000 1.31 +++ html_node/General-Output-Control.html 14 Aug 2021 20:46:40 -0000 1.32 @@ -1,8 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> <html> +<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual is for grep, a pattern matching engine. -Copyright (C) 1999-2002, 2005, 2008-2020 Free Software Foundation, +Copyright (C) 1999-2002, 2005, 2008-2021 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document @@ -11,70 +14,59 @@ 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.5, http://www.gnu.org/software/texinfo/ --> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>General Output Control (GNU Grep 3.5)</title> +<title>General Output Control (GNU Grep 3.7)</title> -<meta name="description" content="General Output Control (GNU Grep 3.5)"> -<meta name="keywords" content="General Output Control (GNU Grep 3.5)"> +<meta name="description" content="General Output Control (GNU Grep 3.7)"> +<meta name="keywords" content="General Output Control (GNU Grep 3.7)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> -<link href="index.html#Top" rel="start" title="Top"> -<link href="Index.html#Index" rel="index" title="Index"> +<meta name="viewport" content="width=device-width,initial-scale=1"> + +<link href="index.html" rel="start" title="Top"> +<link href="Index.html" rel="index" title="Index"> <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="Command_002dline-Options.html#Command_002dline-Options" rel="up" title="Command-line Options"> -<link href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control" rel="next" title="Output Line Prefix Control"> -<link href="Matching-Control.html#Matching-Control" rel="prev" title="Matching Control"> +<link href="Command_002dline-Options.html" rel="up" title="Command-line Options"> +<link href="Output-Line-Prefix-Control.html" rel="next" title="Output Line Prefix Control"> +<link href="Matching-Control.html" rel="prev" title="Matching Control"> <style type="text/css"> <!-- +a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} 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.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} +span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> -<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css"> +<link rel="stylesheet" type="text/css" href="https://www.gnu.org/software/gnulib/manual.css";> </head> <body lang="en"> -<a name="General-Output-Control"></a> +<div class="subsection" id="General-Output-Control"> <div class="header"> <p> -Next: <a href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control" accesskey="n" rel="next">Output Line Prefix Control</a>, Previous: <a href="Matching-Control.html#Matching-Control" accesskey="p" rel="prev">Matching Control</a>, Up: <a href="Command_002dline-Options.html#Command_002dline-Options" accesskey="u" rel="up">Command-line Options</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> +Next: <a href="Output-Line-Prefix-Control.html" accesskey="n" rel="next">Output Line Prefix Control</a>, Previous: <a href="Matching-Control.html" accesskey="p" rel="prev">Matching Control</a>, Up: <a href="Command_002dline-Options.html" accesskey="u" rel="up">Command-line Options</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p> </div> <hr> -<a name="General-Output-Control-1"></a> -<h4 class="subsection">2.1.3 General Output Control</h4> +<span id="General-Output-Control-1"></span><h4 class="subsection">2.1.3 General Output Control</h4> <dl compact="compact"> -<dt><samp>-c</samp></dt> -<dt><samp>--count</samp></dt> -<dd><a name="index-_002dc"></a> -<a name="index-_002d_002dcount"></a> -<a name="index-counting-lines"></a> +<dt id='index-_002dc'><span><samp>-c</samp><a href='#index-_002dc' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--count</samp></span></dt> +<dd><span id="index-_002d_002dcount"></span> +<span id="index-counting-lines"></span> <p>Suppress normal output; instead print a count of matching lines for each input file. With the <samp>-v</samp> (<samp>--invert-match</samp>) option, @@ -82,11 +74,10 @@ (<samp>-c</samp> is specified by POSIX.) </p> </dd> -<dt><samp>--color[=<var>WHEN</var>]</samp></dt> -<dt><samp>--colour[=<var>WHEN</var>]</samp></dt> -<dd><a name="index-_002d_002dcolor"></a> -<a name="index-_002d_002dcolour"></a> -<a name="index-highlight_002c-color_002c-colour"></a> +<dt id='index-_002d_002dcolor'><span><samp>--color[=<var>WHEN</var>]</samp><a href='#index-_002d_002dcolor' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--colour[=<var>WHEN</var>]</samp></span></dt> +<dd><span id="index-_002d_002dcolour"></span> +<span id="index-highlight_002c-color_002c-colour"></span> <p>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 @@ -102,34 +93,30 @@ <var>WHEN</var> is ‘<samp>never</samp>’, ‘<samp>always</samp>’, or ‘<samp>auto</samp>’. </p> </dd> -<dt><samp>-L</samp></dt> -<dt><samp>--files-without-match</samp></dt> -<dd><a name="index-_002dL"></a> -<a name="index-_002d_002dfiles_002dwithout_002dmatch"></a> -<a name="index-files-which-don_0027t-match"></a> +<dt id='index-_002dL'><span><samp>-L</samp><a href='#index-_002dL' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--files-without-match</samp></span></dt> +<dd><span id="index-_002d_002dfiles_002dwithout_002dmatch"></span> +<span id="index-files-which-don_0027t-match"></span> <p>Suppress normal output; instead print the name of each input file from which no output would normally have been printed. -The scanning of each file stops on the first match. </p> </dd> -<dt><samp>-l</samp></dt> -<dt><samp>--files-with-matches</samp></dt> -<dd><a name="index-_002dl"></a> -<a name="index-_002d_002dfiles_002dwith_002dmatches"></a> -<a name="index-names-of-matching-files"></a> +<dt id='index-_002dl'><span><samp>-l</samp><a href='#index-_002dl' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--files-with-matches</samp></span></dt> +<dd><span id="index-_002d_002dfiles_002dwith_002dmatches"></span> +<span id="index-names-of-matching-files"></span> <p>Suppress normal output; instead print the name of each input file from which output would normally have been printed. -The scanning of each file stops on the first match. +Scanning each input file stops upon first match. (<samp>-l</samp> is specified by POSIX.) </p> </dd> -<dt><samp>-m <var>num</var></samp></dt> -<dt><samp>--max-count=<var>num</var></samp></dt> -<dd><a name="index-_002dm"></a> -<a name="index-_002d_002dmax_002dcount"></a> -<a name="index-max_002dcount"></a> +<dt id='index-_002dm'><span><samp>-m <var>num</var></samp><a href='#index-_002dm' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--max-count=<var>num</var></samp></span></dt> +<dd><span id="index-_002d_002dmax_002dcount"></span> +<span id="index-max_002dcount"></span> <p>Stop after the first <var>num</var> selected lines. If the input is standard input from a regular file, and <var>num</var> selected lines are output, @@ -158,7 +145,7 @@ done </pre></div> -<a name="index-context-lines"></a> +<span id="index-context-lines"></span> <p>When <code>grep</code> stops after <var>num</var> selected lines, it outputs any trailing context lines. When the <samp>-c</samp> or <samp>--count</samp> option is also used, @@ -167,24 +154,22 @@ <code>grep</code> stops after outputting <var>num</var> non-matching lines. </p> </dd> -<dt><samp>-o</samp></dt> -<dt><samp>--only-matching</samp></dt> -<dd><a name="index-_002do"></a> -<a name="index-_002d_002donly_002dmatching"></a> -<a name="index-only-matching"></a> +<dt id='index-_002do'><span><samp>-o</samp><a href='#index-_002do' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--only-matching</samp></span></dt> +<dd><span id="index-_002d_002donly_002dmatching"></span> +<span id="index-only-matching"></span> <p>Print only the matched (non-empty) parts of matching lines, with each such part on a separate output line. Output lines use the same delimiters as input, and delimiters are null -bytes if <samp>-z</samp> (<samp>--null-data</samp>) is also used (see <a href="Other-Options.html#Other-Options">Other Options</a>). +bytes if <samp>-z</samp> (<samp>--null-data</samp>) is also used (see <a href="Other-Options.html">Other Options</a>). </p> </dd> -<dt><samp>-q</samp></dt> -<dt><samp>--quiet</samp></dt> -<dt><samp>--silent</samp></dt> -<dd><a name="index-_002dq"></a> -<a name="index-_002d_002dquiet"></a> -<a name="index-_002d_002dsilent"></a> -<a name="index-quiet_002c-silent"></a> +<dt id='index-_002dq'><span><samp>-q</samp><a href='#index-_002dq' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--quiet</samp></span></dt> +<dt><span><samp>--silent</samp></span></dt> +<dd><span id="index-_002d_002dquiet"></span> +<span id="index-_002d_002dsilent"></span> +<span id="index-quiet_002c-silent"></span> <p>Quiet; do not write anything to standard output. Exit immediately with zero status if any match is found, even if an error was detected. @@ -192,18 +177,17 @@ (<samp>-q</samp> is specified by POSIX.) </p> </dd> -<dt><samp>-s</samp></dt> -<dt><samp>--no-messages</samp></dt> -<dd><a name="index-_002ds"></a> -<a name="index-_002d_002dno_002dmessages"></a> -<a name="index-suppress-error-messages"></a> +<dt id='index-_002ds'><span><samp>-s</samp><a href='#index-_002ds' class='copiable-anchor'> ¶</a></span></dt> +<dt><span><samp>--no-messages</samp></span></dt> +<dd><span id="index-_002d_002dno_002dmessages"></span> +<span id="index-suppress-error-messages"></span> <p>Suppress error messages about nonexistent or unreadable files. Portability note: unlike GNU <code>grep</code>, 7th Edition Unix <code>grep</code> did not conform to POSIX, because it lacked <samp>-q</samp> and its <samp>-s</samp> option behaved like -GNU <code>grep</code>’s <samp>-q</samp> option.<a name="DOCF1" href="#FOOT1"><sup>1</sup></a> +GNU <code>grep</code>’s <samp>-q</samp> option.<a id="DOCF1" href="#FOOT1"><sup>1</sup></a> USG-style <code>grep</code> also lacked <samp>-q</samp> but its <samp>-s</samp> option behaved like GNU <code>grep</code>’s. Portable shell scripts should avoid both @@ -214,18 +198,19 @@ </dd> </dl> +</div> <div class="footnote"> <hr> <h4 class="footnotes-heading">Footnotes</h4> -<h3><a name="FOOT1" href="#DOCF1">(1)</a></h3> +<h5><a id="FOOT1" href="#DOCF1">(1)</a></h5> <p>Of course, 7th Edition Unix predated POSIX by several years!</p> </div> <hr> <div class="header"> <p> -Next: <a href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control" accesskey="n" rel="next">Output Line Prefix Control</a>, Previous: <a href="Matching-Control.html#Matching-Control" accesskey="p" rel="prev">Matching Control</a>, Up: <a href="Command_002dline-Options.html#Command_002dline-Options" accesskey="u" rel="up">Command-line Options</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> +Next: <a href="Output-Line-Prefix-Control.html">Output Line Prefix Control</a>, Previous: <a href="Matching-Control.html">Matching Control</a>, Up: <a href="Command_002dline-Options.html">Command-line Options</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p> </div>
