diff options
author | ph10 <ph10@2f5784b3-3f2a-0410-8824-cb99058d5e15> | 2013-11-10 19:04:34 +0000 |
---|---|---|
committer | ph10 <ph10@2f5784b3-3f2a-0410-8824-cb99058d5e15> | 2013-11-10 19:04:34 +0000 |
commit | b79cc767bf7081781e78955af3c986c2119bcdd3 (patch) | |
tree | 583022a943abc9aa76252150bbdba279195cd362 /doc | |
parent | 7de890de6074833fd0b0ed433c69a431cd7bf0cb (diff) | |
download | pcre-b79cc767bf7081781e78955af3c986c2119bcdd3.tar.gz |
In /x mode, allow white space before a possessive + character.
git-svn-id: svn://vcs.exim.org/pcre/code/trunk@1396 2f5784b3-3f2a-0410-8824-cb99058d5e15
Diffstat (limited to 'doc')
-rw-r--r-- | doc/pcreapi.3 | 25 | ||||
-rw-r--r-- | doc/pcrecompat.3 | 8 | ||||
-rw-r--r-- | doc/pcrepattern.3 | 9 |
3 files changed, 25 insertions, 17 deletions
diff --git a/doc/pcreapi.3 b/doc/pcreapi.3 index 6c2576d..1ec0760 100644 --- a/doc/pcreapi.3 +++ b/doc/pcreapi.3 @@ -651,15 +651,22 @@ documentation. .sp PCRE_EXTENDED .sp -If this bit is set, white space data characters in the pattern are totally -ignored except when escaped or inside a character class. White space did not -used to include the VT character (code 11), because Perl did not treat this -character as white space. However, Perl changed at release 5.18, so PCRE -followed at release 8.34, and VT is now treated as white space. PCRE_EXTENDED -also causes characters between an unescaped # outside a character class and the -next newline, inclusive, to be ignored. PCRE_EXTENDED is equivalent to -Perl's /x option, and it can be changed within a pattern by a (?x) option -setting. +If this bit is set, most white space characters in the pattern are totally +ignored except when escaped or inside a character class. However, white space +is not allowed within sequences such as (?> that introduce various +parenthesized subpatterns, nor within a numerical quantifier such as {1,3}. +However, ignorable white space is permitted between an item and a following +quantifier and between a quantifier and a following + that indicates +possessiveness. +.P +White space did not used to include the VT character (code 11), because Perl +did not treat this character as white space. However, Perl changed at release +5.18, so PCRE followed at release 8.34, and VT is now treated as white space. +.P +PCRE_EXTENDED also causes characters between an unescaped # outside a character +class and the next newline, inclusive, to be ignored. PCRE_EXTENDED is +equivalent to Perl's /x option, and it can be changed within a pattern by a +(?x) option setting. .P Which characters are interpreted as newlines is controlled by the options passed to \fBpcre_compile()\fP or by a special sequence at the start of the diff --git a/doc/pcrecompat.3 b/doc/pcrecompat.3 index 1f12cd3..b931efe 100644 --- a/doc/pcrecompat.3 +++ b/doc/pcrecompat.3 @@ -1,4 +1,4 @@ -.TH PCRECOMPAT 3 "05 November 2013" "PCRE 8.34" +.TH PCRECOMPAT 3 "10 November 2013" "PCRE 8.34" .SH NAME PCRE - Perl-compatible regular expressions .SH "DIFFERENCES BETWEEN PCRE AND PERL" @@ -122,8 +122,8 @@ an error is given at compile time. .P 15. Perl recognizes comments in some places that PCRE does not, for example, between the ( and ? at the start of a subpattern. If the /x modifier is set, -Perl allows white space between ( and ? but PCRE never does, even if the -PCRE_EXTENDED option is set. +Perl allows white space between ( and ? (though current Perls warn that this is +deprecated) but PCRE never does, even if the PCRE_EXTENDED option is set. .P 16. Perl, when in warning mode, gives warnings for character classes such as [A-\ed] or [a-[:digit:]]. It then treats the hyphens as literals. PCRE has no @@ -195,6 +195,6 @@ Cambridge CB2 3QH, England. .rs .sp .nf -Last updated: 05 November 2013 +Last updated: 10 November 2013 Copyright (c) 1997-2013 University of Cambridge. .fi diff --git a/doc/pcrepattern.3 b/doc/pcrepattern.3 index 741bb34..367f622 100644 --- a/doc/pcrepattern.3 +++ b/doc/pcrepattern.3 @@ -273,10 +273,11 @@ In a UTF mode, only ASCII numbers and letters have any special meaning after a backslash. All other characters (in particular, those whose codepoints are greater than 127) are treated as literals. .P -If a pattern is compiled with the PCRE_EXTENDED option, white space in the -pattern (other than in a character class) and characters between a # outside -a character class and the next newline are ignored. An escaping backslash can -be used to include a white space or # character as part of the pattern. +If a pattern is compiled with the PCRE_EXTENDED option, most white space in the +pattern (other than in a character class), and characters between a # outside a +character class and the next newline, inclusive, are ignored. An escaping +backslash can be used to include a white space or # character as part of the +pattern. .P If you want to remove the special meaning from a sequence of characters, you can do so by putting them between \eQ and \eE. This is different from Perl in |