summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorph10 <ph10@2f5784b3-3f2a-0410-8824-cb99058d5e15>2009-03-08 16:56:58 +0000
committerph10 <ph10@2f5784b3-3f2a-0410-8824-cb99058d5e15>2009-03-08 16:56:58 +0000
commit93fe69f518b21b77fd329544a82f951a0cefce5b (patch)
tree2c622741dfd3648dd868b7d14a17ca81852efb22
parent47ada1bcf8ce5ed524c685d8ed483c9d81a701fa (diff)
downloadpcre-93fe69f518b21b77fd329544a82f951a0cefce5b.tar.gz
Document named subpattern behaviour in the presence of duplicate numbers.
git-svn-id: svn://vcs.exim.org/pcre/code/trunk@385 2f5784b3-3f2a-0410-8824-cb99058d5e15
-rw-r--r--ChangeLog2
-rw-r--r--doc/pcreapi.38
-rw-r--r--doc/pcrepattern.38
3 files changed, 13 insertions, 5 deletions
diff --git a/ChangeLog b/ChangeLog
index 9369d37..ecd3004 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -49,7 +49,7 @@ Version 7.9 xx-xxx-09
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
diff --git a/doc/pcreapi.3 b/doc/pcreapi.3
index 3bb39d7..0f37679 100644
--- a/doc/pcreapi.3
+++ b/doc/pcreapi.3
@@ -1729,7 +1729,11 @@ These functions call \fBpcre_get_stringnumber()\fP, and if it succeeds, they
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
@@ -1978,6 +1982,6 @@ Cambridge CB2 3QH, England.
.rs
.sp
.nf
-Last updated: 28 February 2009
+Last updated: 08 March 2009
Copyright (c) 1997-2009 University of Cambridge.
.fi
diff --git a/doc/pcrepattern.3 b/doc/pcrepattern.3
index 19895b3..1189b29 100644
--- a/doc/pcrepattern.3
+++ b/doc/pcrepattern.3
@@ -1211,6 +1211,10 @@ details of the interfaces for handling named subpatterns, see the
\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 @@ Cambridge CB2 3QH, England.
.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