CVSROOT: /webcvs/grep Module name: grep Changes by: Jim Meyering <meyering> 25/04/11 13:06:09
Index: html_node/General-Output-Control.html =================================================================== RCS file: /webcvs/grep/grep/manual/html_node/General-Output-Control.html,v retrieving revision 1.35 retrieving revision 1.36 diff -u -b -r1.35 -r1.36 --- html_node/General-Output-Control.html 13 May 2023 09:23:53 -0000 1.35 +++ html_node/General-Output-Control.html 11 Apr 2025 17:06:07 -0000 1.36 @@ -1,11 +1,11 @@ <!DOCTYPE html> <html> -<!-- Created by GNU Texinfo 7.0dev, https://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 7.1.1, 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 © 1999-2002, 2005, 2008-2023 Free Software Foundation, +Copyright © 1999-2002, 2005, 2008-2025 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document @@ -14,10 +14,10 @@ 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". --> -<title>General Output Control (GNU Grep 3.11)</title> +<title>General Output Control (GNU Grep 3.12)</title> -<meta name="description" content="General Output Control (GNU Grep 3.11)"> -<meta name="keywords" content="General Output Control (GNU Grep 3.11)"> +<meta name="description" content="General Output Control (GNU Grep 3.12)"> +<meta name="keywords" content="General Output Control (GNU Grep 3.12)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> @@ -51,24 +51,22 @@ <h4 class="subsection" id="General-Output-Control-1"><span>2.1.3 General Output Control<a class="copiable-link" href="#General-Output-Control-1"> ¶</a></span></h4> <dl class="table"> -<dt><samp class="option">-c</samp></dt> -<dt><samp class="option">--count</samp></dt> -<dd><a class="index-entry-id" id="index-_002dc"></a> -<a class="index-entry-id" id="index-_002d_002dcount"></a> +<dt><a class="index-entry-id" id="index-_002d_002dcount"></a> <a class="index-entry-id" id="index-counting-lines"></a> -<p>Suppress normal output; +<a id="index-_002dc"></a><span><samp class="option">-c</samp><a class="copiable-link" href="#index-_002dc"> ¶</a></span></dt> +<dt><samp class="option">--count</samp></dt> +<dd><p>Suppress normal output; instead print a count of matching lines for each input file. With the <samp class="option">-v</samp> (<samp class="option">--invert-match</samp>) option, count non-matching lines. (<samp class="option">-c</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">--color[=<var class="var">WHEN</var>]</samp></dt> -<dt><samp class="option">--colour[=<var class="var">WHEN</var>]</samp></dt> -<dd><a class="index-entry-id" id="index-_002d_002dcolor"></a> -<a class="index-entry-id" id="index-_002d_002dcolour"></a> +<dt><a class="index-entry-id" id="index-_002d_002dcolour"></a> <a class="index-entry-id" id="index-highlight_002c-color_002c-colour"></a> -<p>Surround matched non-empty strings, matching lines, context lines, +<a id="index-_002d_002dcolor"></a><span><samp class="option">--color[=<var class="var">WHEN</var>]</samp><a class="copiable-link" href="#index-_002d_002dcolor"> ¶</a></span></dt> +<dt><samp class="option">--colour[=<var class="var">WHEN</var>]</samp></dt> +<dd><p>Surround 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. @@ -86,34 +84,31 @@ if no <samp class="option">--color</samp> option is given, the default is <samp class="option">--color=never</samp>. </p> </dd> -<dt><samp class="option">-L</samp></dt> -<dt><samp class="option">--files-without-match</samp></dt> -<dd><a class="index-entry-id" id="index-_002dL"></a> -<a class="index-entry-id" id="index-_002d_002dfiles_002dwithout_002dmatch"></a> +<dt><a class="index-entry-id" id="index-_002d_002dfiles_002dwithout_002dmatch"></a> <a class="index-entry-id" id="index-files-which-don_0027t-match"></a> -<p>Suppress normal output; +<a id="index-_002dL"></a><span><samp class="option">-L</samp><a class="copiable-link" href="#index-_002dL"> ¶</a></span></dt> +<dt><samp class="option">--files-without-match</samp></dt> +<dd><p>Suppress normal output; instead print the name of each input file from which no output would normally have been printed. </p> </dd> -<dt><samp class="option">-l</samp></dt> -<dt><samp class="option">--files-with-matches</samp></dt> -<dd><a class="index-entry-id" id="index-_002dl"></a> -<a class="index-entry-id" id="index-_002d_002dfiles_002dwith_002dmatches"></a> +<dt><a class="index-entry-id" id="index-_002d_002dfiles_002dwith_002dmatches"></a> <a class="index-entry-id" id="index-names-of-matching-files"></a> -<p>Suppress normal output; +<a id="index-_002dl"></a><span><samp class="option">-l</samp><a class="copiable-link" href="#index-_002dl"> ¶</a></span></dt> +<dt><samp class="option">--files-with-matches</samp></dt> +<dd><p>Suppress normal output; instead print the name of each input file from which output would normally have been printed. Scanning each input file stops upon first match. (<samp class="option">-l</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">-m <var class="var">num</var></samp></dt> -<dt><samp class="option">--max-count=<var class="var">num</var></samp></dt> -<dd><a class="index-entry-id" id="index-_002dm"></a> -<a class="index-entry-id" id="index-_002d_002dmax_002dcount"></a> +<dt><a class="index-entry-id" id="index-_002d_002dmax_002dcount"></a> <a class="index-entry-id" id="index-max_002dcount"></a> -<p>Stop after the first <var class="var">num</var> selected lines. +<a id="index-_002dm"></a><span><samp class="option">-m <var class="var">num</var></samp><a class="copiable-link" href="#index-_002dm"> ¶</a></span></dt> +<dt><samp class="option">--max-count=<var class="var">num</var></samp></dt> +<dd><p>Stop after the first <var class="var">num</var> selected lines. If <var class="var">num</var> is zero, <code class="command">grep</code> stops right away without reading input. A <var class="var">num</var> of −1 is treated as infinity and <code class="command">grep</code> does not stop; this is the default. @@ -154,25 +149,23 @@ <code class="command">grep</code> stops after outputting <var class="var">num</var> non-matching lines. </p> </dd> -<dt><samp class="option">-o</samp></dt> -<dt><samp class="option">--only-matching</samp></dt> -<dd><a class="index-entry-id" id="index-_002do"></a> -<a class="index-entry-id" id="index-_002d_002donly_002dmatching"></a> +<dt><a class="index-entry-id" id="index-_002d_002donly_002dmatching"></a> <a class="index-entry-id" id="index-only-matching"></a> -<p>Print only the matched non-empty parts of matching lines, +<a id="index-_002do"></a><span><samp class="option">-o</samp><a class="copiable-link" href="#index-_002do"> ¶</a></span></dt> +<dt><samp class="option">--only-matching</samp></dt> +<dd><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 class="option">-z</samp> (<samp class="option">--null-data</samp>) is also used (see <a class="pxref" href="Other-Options.html">Other Options</a>). </p> </dd> -<dt><samp class="option">-q</samp></dt> -<dt><samp class="option">--quiet</samp></dt> -<dt><samp class="option">--silent</samp></dt> -<dd><a class="index-entry-id" id="index-_002dq"></a> -<a class="index-entry-id" id="index-_002d_002dquiet"></a> +<dt><a class="index-entry-id" id="index-_002d_002dquiet"></a> <a class="index-entry-id" id="index-_002d_002dsilent"></a> <a class="index-entry-id" id="index-quiet_002c-silent"></a> -<p>Quiet; do not write anything to standard output. +<a id="index-_002dq"></a><span><samp class="option">-q</samp><a class="copiable-link" href="#index-_002dq"> ¶</a></span></dt> +<dt><samp class="option">--quiet</samp></dt> +<dt><samp class="option">--silent</samp></dt> +<dd><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. Also see the <samp class="option">-s</samp> or <samp class="option">--no-messages</samp> option. @@ -182,12 +175,11 @@ (<samp class="option">-q</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">-s</samp></dt> -<dt><samp class="option">--no-messages</samp></dt> -<dd><a class="index-entry-id" id="index-_002ds"></a> -<a class="index-entry-id" id="index-_002d_002dno_002dmessages"></a> +<dt><a class="index-entry-id" id="index-_002d_002dno_002dmessages"></a> <a class="index-entry-id" id="index-suppress-error-messages"></a> -<p>Suppress error messages about nonexistent or unreadable files. +<a id="index-_002ds"></a><span><samp class="option">-s</samp><a class="copiable-link" href="#index-_002ds"> ¶</a></span></dt> +<dt><samp class="option">--no-messages</samp></dt> +<dd><p>Suppress error messages about nonexistent or unreadable files. (<samp class="option">-s</samp> is specified by POSIX.) </p> </dd>
