grep-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Changes to manual/html_node/Context-Line-Control.html


From: Karl Berry
Subject: Changes to manual/html_node/Context-Line-Control.html
Date: Sun, 24 May 2009 18:43:07 +0000

CVSROOT:        /web/grep
Module name:    grep
Changes by:     Karl Berry <karl>       09/05/24 18:43:01

Index: manual/html_node/Context-Line-Control.html
===================================================================
RCS file: manual/html_node/Context-Line-Control.html
diff -N manual/html_node/Context-Line-Control.html
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ manual/html_node/Context-Line-Control.html  24 May 2009 18:42:58 -0000      
1.1
@@ -0,0 +1,80 @@
+<html lang="en">
+<head>
+<title>Context Line Control - GNU Grep 2.5.4</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="GNU Grep 2.5.4">
+<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">
+<!--
+This manual is for `grep', a pattern matching engine.
+
+Copyright (C) 1999, 2000, 2001, 2002, 2005, 2008, 2009 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>
+</head>
+<body>
+<div class="node">
+<a name="Context-Line-Control"></a>
+<p>
+Next:&nbsp;<a rel="next" accesskey="n" 
href="File-and-Directory-Selection.html#File-and-Directory-Selection">File and 
Directory Selection</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" 
href="Output-Line-Prefix-Control.html#Output-Line-Prefix-Control">Output Line 
Prefix Control</a>,
+Up:&nbsp;<a rel="up" accesskey="u" 
href="Command_002dline-Options.html#Command_002dline-Options">Command-line 
Options</a>
+<hr>
+</div>
+
+<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 &lsquo;<samp><span class="samp">-o</span></samp>&rsquo; or 
&lsquo;<samp><span class="samp">--only-matching</span></samp>&rsquo; option is 
specified,
+these options have no effect and a warning is given upon their use.
+
+     <dl>
+<dt>&lsquo;<samp><span class="samp">-A 
</span><var>num</var></samp>&rsquo;<dt>&lsquo;<samp><span 
class="samp">--after-context=</span><var>num</var></samp>&rsquo;<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>&lsquo;<samp><span class="samp">-B 
</span><var>num</var></samp>&rsquo;<dt>&lsquo;<samp><span 
class="samp">--before-context=</span><var>num</var></samp>&rsquo;<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>&lsquo;<samp><span class="samp">-C 
</span><var>num</var></samp>&rsquo;<dt>&lsquo;<samp><span 
class="samp">-</span><var>num</var></samp>&rsquo;<dt>&lsquo;<samp><span 
class="samp">--context=</span><var>num</var></samp>&rsquo;<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.
+
+   </dl>
+
+   <p>Matching lines normally use &lsquo;<samp><span 
class="samp">:</span></samp>&rsquo; as a separator
+between prefix fields and actual line content. 
+Context (i.e., non-matching) lines use &lsquo;<samp><span 
class="samp">-</span></samp>&rsquo; instead. 
+When no context is specified,
+matching lines are simply output one right after another. 
+When nonzero context is specified,
+lines that are adjacent in the input form a group
+and are output one right after another,
+but disjoint groups of lines are separated by a &lsquo;<samp><span 
class="samp">--</span></samp>&rsquo;
+without any prefix and on a line of its own. 
+Each group may contain several matching lines
+when they are close enough to each other
+that two otherwise adjacent but divided groups connect
+and can just merge into a single contiguous one.
+
+   </body></html>
+




reply via email to

[Prev in Thread] Current Thread [Next in Thread]