CVSROOT: /webcvs/grep Module name: grep Changes by: Jim Meyering <meyering> 25/04/11 13:06:09
Index: html_node/Output-Line-Prefix-Control.html =================================================================== RCS file: /webcvs/grep/grep/manual/html_node/Output-Line-Prefix-Control.html,v retrieving revision 1.35 retrieving revision 1.36 diff -u -b -r1.35 -r1.36 --- html_node/Output-Line-Prefix-Control.html 13 May 2023 09:23:53 -0000 1.35 +++ html_node/Output-Line-Prefix-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>Output Line Prefix Control (GNU Grep 3.11)</title> +<title>Output Line Prefix Control (GNU Grep 3.12)</title> -<meta name="description" content="Output Line Prefix Control (GNU Grep 3.11)"> -<meta name="keywords" content="Output Line Prefix Control (GNU Grep 3.11)"> +<meta name="description" content="Output Line Prefix Control (GNU Grep 3.12)"> +<meta name="keywords" content="Output Line Prefix Control (GNU Grep 3.12)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> @@ -55,40 +55,36 @@ regardless of the order in which these options were specified. </p> <dl class="table"> -<dt><samp class="option">-b</samp></dt> -<dt><samp class="option">--byte-offset</samp></dt> -<dd><a class="index-entry-id" id="index-_002db"></a> -<a class="index-entry-id" id="index-_002d_002dbyte_002doffset"></a> +<dt><a class="index-entry-id" id="index-_002d_002dbyte_002doffset"></a> <a class="index-entry-id" id="index-byte-offset"></a> -<p>Print the 0-based byte offset within the input file +<a id="index-_002db"></a><span><samp class="option">-b</samp><a class="copiable-link" href="#index-_002db"> ¶</a></span></dt> +<dt><samp class="option">--byte-offset</samp></dt> +<dd><p>Print the 0-based byte offset within the input file before each line of output. If <samp class="option">-o</samp> (<samp class="option">--only-matching</samp>) is specified, print the offset of the matching part itself. </p> </dd> -<dt><samp class="option">-H</samp></dt> -<dt><samp class="option">--with-filename</samp></dt> -<dd><a class="index-entry-id" id="index-_002dH"></a> -<a class="index-entry-id" id="index-_002d_002dwith_002dfilename"></a> +<dt><a class="index-entry-id" id="index-_002d_002dwith_002dfilename"></a> <a class="index-entry-id" id="index-with-filename-prefix"></a> -<p>Print the file name for each match. +<a id="index-_002dH"></a><span><samp class="option">-H</samp><a class="copiable-link" href="#index-_002dH"> ¶</a></span></dt> +<dt><samp class="option">--with-filename</samp></dt> +<dd><p>Print the file name for each match. This is the default when there is more than one file to search. </p> </dd> -<dt><samp class="option">-h</samp></dt> -<dt><samp class="option">--no-filename</samp></dt> -<dd><a class="index-entry-id" id="index-_002dh"></a> -<a class="index-entry-id" id="index-_002d_002dno_002dfilename"></a> +<dt><a class="index-entry-id" id="index-_002d_002dno_002dfilename"></a> <a class="index-entry-id" id="index-no-filename-prefix"></a> -<p>Suppress the prefixing of file names on output. +<a id="index-_002dh"></a><span><samp class="option">-h</samp><a class="copiable-link" href="#index-_002dh"> ¶</a></span></dt> +<dt><samp class="option">--no-filename</samp></dt> +<dd><p>Suppress the prefixing of file names on output. This is the default when there is only one file (or only standard input) to search. </p> </dd> -<dt><samp class="option">--label=<var class="var">LABEL</var></samp></dt> -<dd><a class="index-entry-id" id="index-_002d_002dlabel"></a> -<a class="index-entry-id" id="index-changing-name-of-standard-input"></a> -<p>Display input actually coming from standard input +<dt><a class="index-entry-id" id="index-changing-name-of-standard-input"></a> +<a id="index-_002d_002dlabel"></a><span><samp class="option">--label=<var class="var">LABEL</var></samp><a class="copiable-link" href="#index-_002d_002dlabel"> ¶</a></span></dt> +<dd><p>Display input actually coming from standard input as input coming from file <var class="var">LABEL</var>. This can be useful for commands that transform a file’s contents before searching; e.g.: @@ -98,21 +94,19 @@ </pre></div> </dd> -<dt><samp class="option">-n</samp></dt> -<dt><samp class="option">--line-number</samp></dt> -<dd><a class="index-entry-id" id="index-_002dn"></a> -<a class="index-entry-id" id="index-_002d_002dline_002dnumber"></a> +<dt><a class="index-entry-id" id="index-_002d_002dline_002dnumber"></a> <a class="index-entry-id" id="index-line-numbering"></a> -<p>Prefix each line of output with the 1-based line number within its input file. +<a id="index-_002dn"></a><span><samp class="option">-n</samp><a class="copiable-link" href="#index-_002dn"> ¶</a></span></dt> +<dt><samp class="option">--line-number</samp></dt> +<dd><p>Prefix each line of output with the 1-based line number within its input file. (<samp class="option">-n</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">-T</samp></dt> -<dt><samp class="option">--initial-tab</samp></dt> -<dd><a class="index-entry-id" id="index-_002dT"></a> -<a class="index-entry-id" id="index-_002d_002dinitial_002dtab"></a> +<dt><a class="index-entry-id" id="index-_002d_002dinitial_002dtab"></a> <a class="index-entry-id" id="index-tab_002daligned-content-lines"></a> -<p>Make sure that the first character of actual line content lies on a tab stop, +<a id="index-_002dT"></a><span><samp class="option">-T</samp><a class="copiable-link" href="#index-_002dT"> ¶</a></span></dt> +<dt><samp class="option">--initial-tab</samp></dt> +<dd><p>Make sure that the first character of actual line content lies on a tab stop, so that the alignment of tabs looks normal. This is useful with options that prefix their output to the actual content: <samp class="option">-H</samp>, <samp class="option">-n</samp>, and <samp class="option">-b</samp>. @@ -120,12 +114,11 @@ so that lines from a single file all start at the same column. </p> </dd> -<dt><samp class="option">-Z</samp></dt> -<dt><samp class="option">--null</samp></dt> -<dd><a class="index-entry-id" id="index-_002dZ"></a> -<a class="index-entry-id" id="index-_002d_002dnull"></a> +<dt><a class="index-entry-id" id="index-_002d_002dnull"></a> <a class="index-entry-id" id="index-zero_002dterminated-file-names"></a> -<p>Output a zero byte (the ASCII NUL character) +<a id="index-_002dZ"></a><span><samp class="option">-Z</samp><a class="copiable-link" href="#index-_002dZ"> ¶</a></span></dt> +<dt><samp class="option">--null</samp></dt> +<dd><p>Output a zero byte (the ASCII NUL character) instead of the character that normally follows a file name. For example, ‘<samp class="samp">grep -lZ</samp>’ outputs a zero byte after each file name
