Revision: 1199
http://www.exim.org/viewvc/pcre2?view=rev&revision=1199
Author: ph10
Date: 2019-12-29 11:44:51 +0000 (Sun, 29 Dec 2019)
Log Message:
-----------
Documentation update.
Modified Paths:
--------------
code/trunk/doc/html/pcre2pattern.html
code/trunk/doc/pcre2.txt
code/trunk/doc/pcre2pattern.3
Modified: code/trunk/doc/html/pcre2pattern.html
===================================================================
--- code/trunk/doc/html/pcre2pattern.html 2019-12-28 14:09:09 UTC (rev 1198)
+++ code/trunk/doc/html/pcre2pattern.html 2019-12-29 11:44:51 UTC (rev 1199)
@@ -1650,7 +1650,7 @@
<a href="#group">(defined below),</a>
"succeeds" means matching the rest of the main pattern as well as the
alternative in the group.
-</P>
+<a name="internaloptions"></a></P>
<br><a name="SEC13" href="#TOC1">INTERNAL OPTION SETTING</a><br>
<P>
The settings of the PCRE2_CASELESS, PCRE2_MULTILINE, PCRE2_DOTALL,
@@ -1901,11 +1901,17 @@
(?|(?<AA>aa)|(?<AA>bb))
</pre>
The duplicate name constraint can be disabled by setting the PCRE2_DUPNAMES
-option at compile time, or by the use of (?J) within the pattern. Duplicate
-names can be useful for patterns where only one instance of the named capture
-group can match. Suppose you want to match the name of a weekday, either as a
-3-letter abbreviation or as the full name, and in both cases you want to
-extract the abbreviation. This pattern (ignoring the line breaks) does the job:
+option at compile time, or by the use of (?J) within the pattern, as described
+in the section entitiled
+<a href="#internaloptions">"Internal Option Setting"</a>
+above.
+</P>
+<P>
+Duplicate names can be useful for patterns where only one instance of the named
+capture group can match. Suppose you want to match the name of a weekday,
+either as a 3-letter abbreviation or as the full name, and in both cases you
+want to extract the abbreviation. This pattern (ignoring the line breaks) does
+the job:
<pre>
(?J)
(?<DN>Mon|Fri|Sun)(?:day)?|
@@ -3834,7 +3840,7 @@
</P>
<br><a name="SEC32" href="#TOC1">REVISION</a><br>
<P>
-Last updated: 28 December 2019
+Last updated: 29 December 2019
<br>
Copyright © 1997-2019 University of Cambridge.
<br>
Modified: code/trunk/doc/pcre2.txt
===================================================================
--- code/trunk/doc/pcre2.txt 2019-12-28 14:09:09 UTC (rev 1198)
+++ code/trunk/doc/pcre2.txt 2019-12-29 11:44:51 UTC (rev 1199)
@@ -7671,7 +7671,9 @@
(?|(?<AA>aa)|(?<AA>bb))
The duplicate name constraint can be disabled by setting the PCRE2_DUP-
- NAMES option at compile time, or by the use of (?J) within the pattern.
+ NAMES option at compile time, or by the use of (?J) within the pattern,
+ as described in the section entitiled "Internal Option Setting" above.
+
Duplicate names can be useful for patterns where only one instance of
the named capture group can match. Suppose you want to match the name
of a weekday, either as a 3-letter abbreviation or as the full name,
@@ -9488,7 +9490,7 @@
REVISION
- Last updated: 28 December 2019
+ Last updated: 29 December 2019
Copyright (c) 1997-2019 University of Cambridge.
------------------------------------------------------------------------------
Modified: code/trunk/doc/pcre2pattern.3
===================================================================
--- code/trunk/doc/pcre2pattern.3 2019-12-28 14:09:09 UTC (rev 1198)
+++ code/trunk/doc/pcre2pattern.3 2019-12-29 11:44:51 UTC (rev 1199)
@@ -1,4 +1,4 @@
-.TH PCRE2PATTERN 3 "28 December 2019" "PCRE2 10.35"
+.TH PCRE2PATTERN 3 "29 December 2019" "PCRE2 10.35"
.SH NAME
PCRE2 - Perl-compatible regular expressions (revised API)
.SH "PCRE2 REGULAR EXPRESSION DETAILS"
@@ -1643,6 +1643,7 @@
alternative in the group.
.
.
+.\" HTML <a name="internaloptions"></a>
.SH "INTERNAL OPTION SETTING"
.rs
.sp
@@ -1901,11 +1902,19 @@
(?|(?<AA>aa)|(?<AA>bb))
.sp
The duplicate name constraint can be disabled by setting the PCRE2_DUPNAMES
-option at compile time, or by the use of (?J) within the pattern. Duplicate
-names can be useful for patterns where only one instance of the named capture
-group can match. Suppose you want to match the name of a weekday, either as a
-3-letter abbreviation or as the full name, and in both cases you want to
-extract the abbreviation. This pattern (ignoring the line breaks) does the job:
+option at compile time, or by the use of (?J) within the pattern, as described
+in the section entitiled
+.\" HTML <a href="#internaloptions">
+.\" </a>
+"Internal Option Setting"
+.\"
+above.
+.P
+Duplicate names can be useful for patterns where only one instance of the named
+capture group can match. Suppose you want to match the name of a weekday,
+either as a 3-letter abbreviation or as the full name, and in both cases you
+want to extract the abbreviation. This pattern (ignoring the line breaks) does
+the job:
.sp
(?J)
(?<DN>Mon|Fri|Sun)(?:day)?|
@@ -3875,6 +3884,6 @@
.rs
.sp
.nf
-Last updated: 28 December 2019
+Last updated: 29 December 2019
Copyright (c) 1997-2019 University of Cambridge.
.fi
