Revision: 385
http://vcs.pcre.org/viewvc?view=rev&revision=385
Author: ph10
Date: 2009-03-08 16:56:58 +0000 (Sun, 08 Mar 2009)
Log Message:
-----------
Document named subpattern behaviour in the presence of duplicate numbers.
Modified Paths:
--------------
code/trunk/ChangeLog
code/trunk/doc/pcreapi.3
code/trunk/doc/pcrepattern.3
Modified: code/trunk/ChangeLog
===================================================================
--- code/trunk/ChangeLog 2009-03-08 16:27:43 UTC (rev 384)
+++ code/trunk/ChangeLog 2009-03-08 16:56:58 UTC (rev 385)
@@ -49,7 +49,7 @@
used for matching.
11. Unicode property support in character classes was not working for
- characters (bytes) greater than 128 when not in UTF-8 mode.
+ characters (bytes) greater than 127 when not in UTF-8 mode.
Version 7.8 05-Sep-08
Modified: code/trunk/doc/pcreapi.3
===================================================================
--- code/trunk/doc/pcreapi.3 2009-03-08 16:27:43 UTC (rev 384)
+++ code/trunk/doc/pcreapi.3 2009-03-08 16:56:58 UTC (rev 385)
@@ -1729,8 +1729,12 @@
then call \fBpcre_copy_substring()\fP or \fBpcre_get_substring()\fP, as
appropriate. \fBNOTE:\fP If PCRE_DUPNAMES is set and there are duplicate names,
the behaviour may not be what you want (see the next section).
+.P
+\fBWarning:\fP If the pattern uses the "(?|" feature to set up multiple
+subpatterns with the same number, you cannot use names to distinguish them,
+because names are not included in the compiled code. The matching process uses
+only numbers.
.
-.
.SH "DUPLICATE SUBPATTERN NAMES"
.rs
.sp
@@ -1978,6 +1982,6 @@
.rs
.sp
.nf
-Last updated: 28 February 2009
+Last updated: 08 March 2009
Copyright (c) 1997-2009 University of Cambridge.
.fi
Modified: code/trunk/doc/pcrepattern.3
===================================================================
--- code/trunk/doc/pcrepattern.3 2009-03-08 16:27:43 UTC (rev 384)
+++ code/trunk/doc/pcrepattern.3 2009-03-08 16:56:58 UTC (rev 385)
@@ -1211,6 +1211,10 @@
\fBpcreapi\fP
.\"
documentation.
+.P
+\fBWarning:\fP You cannot use different names to distinguish between two
+subpatterns with the same number (see the previous section) because PCRE uses
+only the numbers when matching.
.
.
.SH REPETITION
@@ -2240,6 +2244,6 @@
.rs
.sp
.nf
-Last updated: 19 April 2008
-Copyright (c) 1997-2008 University of Cambridge.
+Last updated: 08 March 2009
+Copyright (c) 1997-2009 University of Cambridge.
.fi