Revision: 529
http://www.exim.org/viewvc/pcre2?view=rev&revision=529
Author: ph10
Date: 2016-06-19 17:07:56 +0100 (Sun, 19 Jun 2016)
Log Message:
-----------
Documentation clarification.
Modified Paths:
--------------
code/trunk/doc/pcre2grep.1
Modified: code/trunk/doc/pcre2grep.1
===================================================================
--- code/trunk/doc/pcre2grep.1 2016-06-17 17:37:26 UTC (rev 528)
+++ code/trunk/doc/pcre2grep.1 2016-06-19 16:07:56 UTC (rev 529)
@@ -1,4 +1,4 @@
-.TH PCRE2GREP 1 "06 April 2016" "PCRE2 10.22"
+.TH PCRE2GREP 1 "19 June 2016" "PCRE2 10.22"
.SH NAME
pcre2grep - a grep with Perl-compatible regular expressions.
.SH SYNOPSIS
@@ -440,10 +440,15 @@
line in which the match ended. If the matched string ends with a newline
sequence the output ends at the end of that line.
.sp
-When this option is set, the PCRE2 library is called in "multiline" mode.
-However, \fBpcre2grep\fP still processes the input line by line. The difference
-is that a matched string may extend past the end of a line and continue on
-one or more subsequent lines. The newline sequence must be matched as part of
+When this option is set, the PCRE2 library is called in "multiline" mode. This
+allows a matched string to extend past the end of a line and continue on one or
+more subsequent lines. However, \fBpcre2grep\fP still processes the input line
+by line. Once a match has been handled, scanning restarts at the beginning of
+the next line, just as it does when \fB-M\fP is not present. This means that it
+is possible for the second or subsequent lines in a multiline match to be
+output again as part of another match.
+.sp
+The newline sequence that separates multiple lines must be matched as part of
the pattern. For example, to find the phrase "regular expression" in a file
where "regular" might be at the end of a line and "expression" at the start of
the next line, you could use this command:
@@ -752,6 +757,6 @@
.rs
.sp
.nf
-Last updated: 06 April 2016
+Last updated: 19 June 2016
Copyright (c) 1997-2016 University of Cambridge.
.fi
