[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Changes to grep/manual/html_node/Output-Line-Prefix-Control.html,v
|
From: |
Jim Meyering |
|
Subject: |
Changes to grep/manual/html_node/Output-Line-Prefix-Control.html,v |
|
Date: |
Wed, 22 Mar 2023 22:55:26 -0400 (EDT) |
CVSROOT: /webcvs/grep
Module name: grep
Changes by: Jim Meyering <meyering> 23/03/22 22:55:22
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.33
retrieving revision 1.34
diff -u -b -r1.33 -r1.34
--- html_node/Output-Line-Prefix-Control.html 3 Sep 2022 19:33:14 -0000
1.33
+++ html_node/Output-Line-Prefix-Control.html 23 Mar 2023 02:55:21 -0000
1.34
@@ -1,11 +1,11 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.0dev, 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-2022 Free Software Foundation,
+Copyright © 1999-2002, 2005, 2008-2023 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.8)</title>
+<title>Output Line Prefix Control (GNU Grep 3.10)</title>
-<meta name="description" content="Output Line Prefix Control (GNU Grep 3.8)">
-<meta name="keywords" content="Output Line Prefix Control (GNU Grep 3.8)">
+<meta name="description" content="Output Line Prefix Control (GNU Grep 3.10)">
+<meta name="keywords" content="Output Line Prefix Control (GNU Grep 3.10)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -31,21 +31,9 @@
<link href="General-Output-Control.html" rel="prev" title="General Output
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}
-div.display {margin-left: 3.2em}
+a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
div.example {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}
-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}
+span:hover a.copiable-link {visibility: visible}
-->
</style>
<link rel="stylesheet" type="text/css"
href="https://www.gnu.org/software/gnulib/manual.css";>
@@ -54,91 +42,98 @@
</head>
<body lang="en">
-<div class="subsection" id="Output-Line-Prefix-Control">
-<div class="header">
+<div class="subsection-level-extent" id="Output-Line-Prefix-Control">
+<div class="nav-panel">
<p>
Next: <a href="Context-Line-Control.html" accesskey="n" rel="next">Context
Line Control</a>, Previous: <a href="General-Output-Control.html" accesskey="p"
rel="prev">General Output 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>
-<span id="Output-Line-Prefix-Control-1"></span><h4 class="subsection">2.1.4
Output Line Prefix Control</h4>
+<h4 class="subsection" id="Output-Line-Prefix-Control-1"><span>2.1.4 Output
Line Prefix Control<a class="copiable-link"
href="#Output-Line-Prefix-Control-1"> ¶</a></span></h4>
<p>When several prefix fields are to be output,
the order is always file name, line number, and byte offset,
regardless of the order in which these options were specified.
</p>
-<dl compact="compact">
-<dt id='index-_002db'><span><samp>-b</samp><a href='#index-_002db'
class='copiable-anchor'> ¶</a></span></dt>
-<dt><span><samp>--byte-offset</samp></span></dt>
-<dd><span id="index-_002d_002dbyte_002doffset"></span>
-<span id="index-byte-offset"></span>
+<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>
+<a class="index-entry-id" id="index-byte-offset"></a>
<p>Print the 0-based byte offset within the input file
before each line of output.
-If <samp>-o</samp> (<samp>--only-matching</samp>) is specified,
+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 id='index-_002dH'><span><samp>-H</samp><a href='#index-_002dH'
class='copiable-anchor'> ¶</a></span></dt>
-<dt><span><samp>--with-filename</samp></span></dt>
-<dd><span id="index-_002d_002dwith_002dfilename"></span>
-<span id="index-with-filename-prefix"></span>
+<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>
+<a class="index-entry-id" id="index-with-filename-prefix"></a>
<p>Print the file name for each match.
This is the default when there is more than one file to search.
</p>
</dd>
-<dt id='index-_002dh'><span><samp>-h</samp><a href='#index-_002dh'
class='copiable-anchor'> ¶</a></span></dt>
-<dt><span><samp>--no-filename</samp></span></dt>
-<dd><span id="index-_002d_002dno_002dfilename"></span>
-<span id="index-no-filename-prefix"></span>
+<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>
+<a class="index-entry-id" id="index-no-filename-prefix"></a>
<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 id='index-_002d_002dlabel'><span><samp>--label=<var>LABEL</var></samp><a
href='#index-_002d_002dlabel' class='copiable-anchor'> ¶</a></span></dt>
-<dd><span id="index-changing-name-of-standard-input"></span>
+<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
-as input coming from file <var>LABEL</var>.
+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.:
</p>
<div class="example">
-<pre class="example">gzip -cd foo.gz | grep --label=foo -H 'some pattern'
+<pre class="example-preformatted">gzip -cd foo.gz | grep --label=foo -H 'some
pattern'
</pre></div>
</dd>
-<dt id='index-_002dn'><span><samp>-n</samp><a href='#index-_002dn'
class='copiable-anchor'> ¶</a></span></dt>
-<dt><span><samp>--line-number</samp></span></dt>
-<dd><span id="index-_002d_002dline_002dnumber"></span>
-<span id="index-line-numbering"></span>
+<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>
+<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.
-(<samp>-n</samp> is specified by POSIX.)
+(<samp class="option">-n</samp> is specified by POSIX.)
</p>
</dd>
-<dt id='index-_002dT'><span><samp>-T</samp><a href='#index-_002dT'
class='copiable-anchor'> ¶</a></span></dt>
-<dt><span><samp>--initial-tab</samp></span></dt>
-<dd><span id="index-_002d_002dinitial_002dtab"></span>
-<span id="index-tab_002daligned-content-lines"></span>
+<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>
+<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,
so that the alignment of tabs looks normal.
This is useful with options that prefix their output to the actual content:
-<samp>-H</samp>, <samp>-n</samp>, and <samp>-b</samp>.
+<samp class="option">-H</samp>, <samp class="option">-n</samp>, and <samp
class="option">-b</samp>.
This may also prepend spaces to output line numbers and byte offsets
so that lines from a single file all start at the same column.
</p>
</dd>
-<dt id='index-_002dZ'><span><samp>-Z</samp><a href='#index-_002dZ'
class='copiable-anchor'> ¶</a></span></dt>
-<dt><span><samp>--null</samp></span></dt>
-<dd><span id="index-_002d_002dnull"></span>
-<span id="index-zero_002dterminated-file-names"></span>
+<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>
+<a class="index-entry-id" id="index-zero_002dterminated-file-names"></a>
<p>Output a zero byte (the ASCII NUL character)
instead of the character that normally follows a file name.
For example,
-‘<samp>grep -lZ</samp>’ outputs a zero byte after each file name
+‘<samp class="samp">grep -lZ</samp>’ outputs a zero byte after
each file name
instead of the usual newline.
This option makes the output unambiguous,
even in the presence of file names containing unusual characters like newlines.
This option can be used with commands like
-‘<samp>find -print0</samp>’, ‘<samp>perl -0</samp>’,
‘<samp>sort -z</samp>’, and ‘<samp>xargs -0</samp>’
+‘<samp class="samp">find -print0</samp>’, ‘<samp
class="samp">perl -0</samp>’, ‘<samp class="samp">sort
-z</samp>’, and ‘<samp class="samp">xargs -0</samp>’
to process arbitrary file names,
even those that contain newline characters.
</p>
@@ -147,7 +142,7 @@
</div>
<hr>
-<div class="header">
+<div class="nav-panel">
<p>
Next: <a href="Context-Line-Control.html">Context Line Control</a>, Previous:
<a href="General-Output-Control.html">General Output 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>
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- Changes to grep/manual/html_node/Output-Line-Prefix-Control.html,v,
Jim Meyering <=