Documentation clarification.

This commit is contained in:
Philip.Hazel 2016-06-19 16:07:56 +00:00
parent b002f44061
commit fdc2becdcd
1 changed files with 11 additions and 6 deletions

View File

@ -1,4 +1,4 @@
.TH PCRE2GREP 1 "06 April 2016" "PCRE2 10.22" .TH PCRE2GREP 1 "19 June 2016" "PCRE2 10.22"
.SH NAME .SH NAME
pcre2grep - a grep with Perl-compatible regular expressions. pcre2grep - a grep with Perl-compatible regular expressions.
.SH SYNOPSIS .SH SYNOPSIS
@ -440,10 +440,15 @@ one line. The first is the line in which the match started, and the last is the
line in which the match ended. If the matched string ends with a newline line in which the match ended. If the matched string ends with a newline
sequence the output ends at the end of that line. sequence the output ends at the end of that line.
.sp .sp
When this option is set, the PCRE2 library is called in "multiline" mode. When this option is set, the PCRE2 library is called in "multiline" mode. This
However, \fBpcre2grep\fP still processes the input line by line. The difference allows a matched string to extend past the end of a line and continue on one or
is that a matched string may extend past the end of a line and continue on more subsequent lines. However, \fBpcre2grep\fP still processes the input line
one or more subsequent lines. The newline sequence must be matched as part of 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 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 where "regular" might be at the end of a line and "expression" at the start of
the next line, you could use this command: the next line, you could use this command:
@ -752,6 +757,6 @@ Cambridge, England.
.rs .rs
.sp .sp
.nf .nf
Last updated: 06 April 2016 Last updated: 19 June 2016
Copyright (c) 1997-2016 University of Cambridge. Copyright (c) 1997-2016 University of Cambridge.
.fi .fi