grep-commit
[Top][All Lists]
Advanced

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

Changes to grep/manual/html_node/Usage.html,v


From: Jim Meyering
Subject: Changes to grep/manual/html_node/Usage.html,v
Date: Fri, 23 May 2014 05:40:23 +0000

CVSROOT:        /webcvs/grep
Module name:    grep
Changes by:     Jim Meyering <meyering> 14/05/23 05:40:03

Index: html_node/Usage.html
===================================================================
RCS file: /webcvs/grep/grep/manual/html_node/Usage.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- html_node/Usage.html        21 Feb 2014 17:16:50 -0000      1.17
+++ html_node/Usage.html        23 May 2014 05:40:02 -0000      1.18
@@ -1,8 +1,8 @@
 <html lang="en">
 <head>
-<title>Usage - GNU Grep 2.18</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="GNU Grep 2.18">
+<title>Usage - GNU Grep 2.19</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="GNU Grep 2.19">
 <meta name="generator" content="makeinfo 4.13">
 <link title="Top" rel="start" href="index.html#Top">
 <link rel="prev" href="Regular-Expressions.html#Regular-Expressions" 
title="Regular Expressions">
@@ -11,7 +11,7 @@
 <!--
 This manual is for `grep', a pattern matching engine.
 
-Copyright (C) 1999-2002, 2005, 2008-2014 Free Software Foundation,
+Copyright (C) 1999--2002, 2005, 2008--2014 Free Software Foundation,
 Inc.
 
      Permission is granted to copy, distribute and/or modify this
@@ -228,20 +228,16 @@
 
      <p>Standard grep cannot do this, as it is fundamentally line-based. 
 Therefore, merely using the <code>[:space:]</code> character class does not
-match newlines in the way you might expect.  However, if your grep is
-compiled with Perl patterns enabled, the Perl &lsquo;<samp><span 
class="samp">s</span></samp>&rsquo;
-modifier (which makes <code>.</code> match newlines) can be used:
+match newlines in the way you might expect.
 
-     <pre class="example">          printf 'foo\nbar\n' | grep -P 
'(?s)foo.*?bar'
-</pre>
      <p>With the GNU <samp><span class="command">grep</span></samp> option 
<code>-z</code> (see <a 
href="File-and-Directory-Selection.html#File-and-Directory-Selection">File and 
Directory Selection</a>), the input is terminated by null bytes.  Thus,
-you can match newlines in the input, but the output will be the whole
-file, so this is really only useful to determine if the pattern is
-present:
+you can match newlines in the input, but typically if there is a match
+the entire input is output, so this usage is often combined with
+output-suppressing options like <samp><span class="option">-q</span></samp>, 
e.g.:
 
      <pre class="example">          printf 'foo\nbar\n' | grep -z -q 
'foo[[:space:]]\+bar'
 </pre>
-     <p>Failing either of those options, you need to transform the input
+     <p>If this does not suffice, you can transform the input
 before giving it to <samp><span class="command">grep</span></samp>, or turn to 
<samp><span class="command">awk</span></samp>,
 <samp><span class="command">sed</span></samp>, <samp><span 
class="command">perl</span></samp>, or many other utilities that are
 designed to operate across lines.



reply via email to

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