Revision: 458
http://www.exim.org/viewvc/pcre2?view=rev&revision=458
Author: ph10
Date: 2015-12-03 17:19:13 +0000 (Thu, 03 Dec 2015)
Log Message:
-----------
Documentation clarification.
Modified Paths:
--------------
code/trunk/ChangeLog
code/trunk/doc/pcre2api.3
Modified: code/trunk/ChangeLog
===================================================================
--- code/trunk/ChangeLog 2015-12-03 17:08:23 UTC (rev 457)
+++ code/trunk/ChangeLog 2015-12-03 17:19:13 UTC (rev 458)
@@ -370,7 +370,11 @@
space or a #-type comment that was followed by (?-x), which turns off
PCRE2_EXTENDED, and there was no subsequent (?x) to turn it on again,
pcre2_compile() assumed that (?-x) applied to the whole pattern and
-consequently mis-compiled it. This bug was found by the LLVM fuzzer.
+consequently mis-compiled it. This bug was found by the LLVM fuzzer. The fix
+for this bug means that a setting of any of the (?imsxU) options at the start
+of a pattern is no longer transferred to the options that are returned by
+PCRE2_INFO_ALLOPTIONS. In fact, this was an anachronism that should have
+changed when the effects of those options were all moved to compile time.
Version 10.20 30-June-2015
Modified: code/trunk/doc/pcre2api.3
===================================================================
--- code/trunk/doc/pcre2api.3 2015-12-03 17:08:23 UTC (rev 457)
+++ code/trunk/doc/pcre2api.3 2015-12-03 17:19:13 UTC (rev 458)
@@ -1,4 +1,4 @@
-.TH PCRE2API 3 "21 November 2015" "PCRE2 10.21"
+.TH PCRE2API 3 "03 December 2015" "PCRE2 10.21"
.SH NAME
PCRE2 - Perl-compatible regular expressions (revised API)
.sp
@@ -1565,11 +1565,10 @@
Return a copy of the pattern's options. The third argument should point to a
\fBuint32_t\fP variable. PCRE2_INFO_ARGOPTIONS returns exactly the options that
were passed to \fBpcre2_compile()\fP, whereas PCRE2_INFO_ALLOPTIONS returns
-the compile options as modified by any top-level option settings at the start
-of the pattern itself. In other words, they are the options that will be in
-force when matching starts. For example, if the pattern /(?im)abc(?-i)d/ is
-compiled with the PCRE2_EXTENDED option, the result is PCRE2_CASELESS,
-PCRE2_MULTILINE, and PCRE2_EXTENDED.
+the compile options as modified by any top-level option settings such as (*UTF)
+at the start of the pattern itself. For example, if the pattern /(*UTF)abc/ is
+compiled with the PCRE2_EXTENDED option, the result is PCRE2_EXTENDED and
+PCRE2_UTF.
.P
A pattern compiled without PCRE2_ANCHORED is automatically anchored by PCRE2 if
the first significant item in every top-level branch is one of the following:
@@ -3101,6 +3100,6 @@
.rs
.sp
.nf
-Last updated: 21 November 2015
+Last updated: 03 December 2015
Copyright (c) 1997-2015 University of Cambridge.
.fi
