[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Changes to grep/manual/html_node/Context-Line-Control.html,v
|
From: |
Jim Meyering |
|
Subject: |
Changes to grep/manual/html_node/Context-Line-Control.html,v |
|
Date: |
Fri, 05 Feb 2016 00:44:59 +0000 |
CVSROOT: /webcvs/grep
Module name: grep
Changes by: Jim Meyering <meyering> 16/02/05 00:44:53
Index: html_node/Context-Line-Control.html
===================================================================
RCS file: /webcvs/grep/grep/manual/html_node/Context-Line-Control.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -b -r1.21 -r1.22
--- html_node/Context-Line-Control.html 2 Nov 2015 02:54:32 -0000 1.21
+++ html_node/Context-Line-Control.html 5 Feb 2016 00:44:51 -0000 1.22
@@ -1,99 +1,159 @@
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<!-- This manual is for grep, a pattern matching engine.
+
+Copyright (C) 1999-2002, 2005, 2008-2016 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". -->
+<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>Context Line Control - GNU Grep 2.22</title>
+<title>GNU Grep 2.23: Context Line Control</title>
+
+<meta name="description" content="GNU Grep 2.23: Context Line Control">
+<meta name="keywords" content="GNU Grep 2.23: Context Line Control">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<meta name="description" content="GNU Grep 2.22">
-<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="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control" title="Output
Line Prefix Control">
-<link rel="next"
href="File-and-Directory-Selection.html#File-and-Directory-Selection"
title="File and Directory Selection">
-<link href="http://www.gnu.org/software/texinfo/"; rel="generator-home"
title="Texinfo Homepage">
+<link href="index.html#Top" rel="start" title="Top">
+<link href="Index.html#Index" 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="File-and-Directory-Selection.html#File-and-Directory-Selection"
rel="next" title="File and Directory Selection">
+<link href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control"
rel="prev" title="Output Line Prefix Control">
+<style type="text/css">
<!--
-This manual is for `grep', a pattern matching engine.
+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.nocodebreak {white-space: nowrap}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: serif; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
-Copyright (C) 1999-2002, 2005, 2008-2015 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>
-<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
</head>
-<body>
-<div class="node">
+
+<body lang="en">
<a name="Context-Line-Control"></a>
+<div class="header">
<p>
-Next: <a rel="next" accesskey="n"
href="File-and-Directory-Selection.html#File-and-Directory-Selection">File and
Directory Selection</a>,
-Previous: <a rel="previous" accesskey="p"
href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control">Output Line
Prefix Control</a>,
-Up: <a rel="up" accesskey="u"
href="Command_002dline-Options.html#Command_002dline-Options">Command-line
Options</a>
-<hr>
+Next: <a href="File-and-Directory-Selection.html#File-and-Directory-Selection"
accesskey="n" rel="next">File and Directory Selection</a>, Previous: <a
href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control" accesskey="p"
rel="prev">Output Line Prefix 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>
</div>
-
+<hr>
+<a name="Context-Line-Control-1"></a>
<h4 class="subsection">2.1.5 Context Line Control</h4>
<p>Regardless of how these options are set,
-<samp><span class="command">grep</span></samp> will never print any given line
more than once.
-If the <samp><span class="option">-o</span></samp> (<samp><span
class="option">--only-matching</span></samp>) option is specified,
+<code>grep</code> will never print any given line more than once.
+If the <samp>-o</samp> (<samp>--only-matching</samp>) option is specified,
these options have no effect and a warning is given upon their use.
-
- <dl>
-<dt><samp><span class="option">-A </span><var>num</var></samp><dt><samp><span
class="option">--after-context=</span><var>num</var></samp><dd><a
name="index-g_t_002dA-76"></a><a
name="index-g_t_002d_002dafter_002dcontext-77"></a><a
name="index-after-context-78"></a><a
name="index-context-lines_002c-after-match-79"></a>Print <var>num</var> lines
of trailing context after matching lines.
-
- <br><dt><samp><span class="option">-B
</span><var>num</var></samp><dt><samp><span
class="option">--before-context=</span><var>num</var></samp><dd><a
name="index-g_t_002dB-80"></a><a
name="index-g_t_002d_002dbefore_002dcontext-81"></a><a
name="index-before-context-82"></a><a
name="index-context-lines_002c-before-match-83"></a>Print <var>num</var> lines
of leading context before matching lines.
-
- <br><dt><samp><span class="option">-C
</span><var>num</var></samp><dt><samp><span
class="option">-</span><var>num</var></samp><dt><samp><span
class="option">--context=</span><var>num</var></samp><dd><a
name="index-g_t_002dC-84"></a><a name="index-g_t_002d_002dcontext-85"></a><a
name="index-g_t_002d_0040var_007bnum_007d-86"></a><a
name="index-context-87"></a>Print <var>num</var> lines of leading and trailing
output context.
-
- <br><dt><samp><span
class="option">--group-separator=</span><var>string</var></samp><dd><a
name="index-g_t_002d_002dgroup_002dseparator-88"></a><a
name="index-group-separator-89"></a>When <samp><span
class="option">-A</span></samp>, <samp><span class="option">-B</span></samp> or
<samp><span class="option">-C</span></samp> are in use,
-print <var>string</var> instead of <samp><span class="option">--</span></samp>
between groups of lines.
-
- <br><dt><samp><span
class="option">--no-group-separator</span></samp><dd><a
name="index-g_t_002d_002dgroup_002dseparator-90"></a><a
name="index-group-separator-91"></a>When <samp><span
class="option">-A</span></samp>, <samp><span class="option">-B</span></samp> or
<samp><span class="option">-C</span></samp> are in use,
+</p>
+<dl compact="compact">
+<dt><samp>-A <var>num</var></samp></dt>
+<dt><samp>--after-context=<var>num</var></samp></dt>
+<dd><a name="index-_002dA"></a>
+<a name="index-_002d_002dafter_002dcontext"></a>
+<a name="index-after-context"></a>
+<a name="index-context-lines_002c-after-match"></a>
+<p>Print <var>num</var> lines of trailing context after matching lines.
+</p>
+</dd>
+<dt><samp>-B <var>num</var></samp></dt>
+<dt><samp>--before-context=<var>num</var></samp></dt>
+<dd><a name="index-_002dB"></a>
+<a name="index-_002d_002dbefore_002dcontext"></a>
+<a name="index-before-context"></a>
+<a name="index-context-lines_002c-before-match"></a>
+<p>Print <var>num</var> lines of leading context before matching lines.
+</p>
+</dd>
+<dt><samp>-C <var>num</var></samp></dt>
+<dt><samp>-<var>num</var></samp></dt>
+<dt><samp>--context=<var>num</var></samp></dt>
+<dd><a name="index-_002dC"></a>
+<a name="index-_002d_002dcontext"></a>
+<a name="index-_002dnum"></a>
+<a name="index-context"></a>
+<p>Print <var>num</var> lines of leading and trailing output context.
+</p>
+</dd>
+<dt><samp>--group-separator=<var>string</var></samp></dt>
+<dd><a name="index-_002d_002dgroup_002dseparator"></a>
+<a name="index-group-separator"></a>
+<p>When <samp>-A</samp>, <samp>-B</samp> or <samp>-C</samp> are in use,
+print <var>string</var> instead of <samp>--</samp> between groups of lines.
+</p>
+</dd>
+<dt><samp>--no-group-separator</samp></dt>
+<dd><a name="index-_002d_002dgroup_002dseparator-1"></a>
+<a name="index-group-separator-1"></a>
+<p>When <samp>-A</samp>, <samp>-B</samp> or <samp>-C</samp> are in use,
do not print a separator between groups of lines.
+</p>
+</dd>
+</dl>
- </dl>
-
- <p>Here are some points about how <samp><span
class="command">grep</span></samp> chooses
+<p>Here are some points about how <code>grep</code> chooses
the separator to print between prefix fields and line content:
-
- <ul>
-<li>Matching lines normally use ‘<samp><span
class="samp">:</span></samp>’ as a separator
+</p>
+<ul>
+<li> Matching lines normally use ‘<samp>:</samp>’ as a separator
between prefix fields and actual line content.
- <li>Context (i.e., non-matching) lines use ‘<samp><span
class="samp">-</span></samp>’ instead.
+</li><li> Context (i.e., non-matching) lines use ‘<samp>-</samp>’
instead.
- <li>When context is not specified,
+</li><li> When context is not specified,
matching lines are simply output one right after another.
- <li>When context is specified,
+</li><li> When context is specified,
lines that are adjacent in the input form a group
and are output one right after another, while
by default a separator appears between non-adjacent groups.
- <li>The default separator
-is a ‘<samp><span class="samp">--</span></samp>’ line; its
presence and appearance
+</li><li> The default separator
+is a ‘<samp>--</samp>’ line; its presence and appearance
can be changed with the options above.
- <li>Each group may contain
+</li><li> Each group may contain
several matching lines when they are close enough to each other
that two adjacent groups connect and can merge into a single
contiguous one.
-</ul>
+</li></ul>
+
+<hr>
+<div class="header">
+<p>
+Next: <a href="File-and-Directory-Selection.html#File-and-Directory-Selection"
accesskey="n" rel="next">File and Directory Selection</a>, Previous: <a
href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control" accesskey="p"
rel="prev">Output Line Prefix 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>
+</div>
+
- </body></html>
+</body>
+</html>
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- Changes to grep/manual/html_node/Context-Line-Control.html,v,
Jim Meyering <=