Documentation update.

This commit is contained in:
Philip.Hazel 2019-12-29 11:44:51 +00:00
parent f006fa5e3c
commit 279128cbde
3 changed files with 33 additions and 16 deletions

View File

@ -1650,7 +1650,7 @@ that succeeds is used. If the alternatives are within a group
<a href="#group">(defined below),</a> <a href="#group">(defined below),</a>
"succeeds" means matching the rest of the main pattern as well as the "succeeds" means matching the rest of the main pattern as well as the
alternative in the group. alternative in the group.
</P> <a name="internaloptions"></a></P>
<br><a name="SEC13" href="#TOC1">INTERNAL OPTION SETTING</a><br> <br><a name="SEC13" href="#TOC1">INTERNAL OPTION SETTING</a><br>
<P> <P>
The settings of the PCRE2_CASELESS, PCRE2_MULTILINE, PCRE2_DOTALL, The settings of the PCRE2_CASELESS, PCRE2_MULTILINE, PCRE2_DOTALL,
@ -1901,11 +1901,17 @@ are permitted for groups with the same number, for example:
(?|(?&#60;AA&#62;aa)|(?&#60;AA&#62;bb)) (?|(?&#60;AA&#62;aa)|(?&#60;AA&#62;bb))
</pre> </pre>
The duplicate name constraint can be disabled by setting the PCRE2_DUPNAMES 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 option at compile time, or by the use of (?J) within the pattern, as described
names can be useful for patterns where only one instance of the named capture in the section entitiled
group can match. Suppose you want to match the name of a weekday, either as a <a href="#internaloptions">"Internal Option Setting"</a>
3-letter abbreviation or as the full name, and in both cases you want to above.
extract the abbreviation. This pattern (ignoring the line breaks) does the job: </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> <pre>
(?J) (?J)
(?&#60;DN&#62;Mon|Fri|Sun)(?:day)?| (?&#60;DN&#62;Mon|Fri|Sun)(?:day)?|
@ -3834,7 +3840,7 @@ Cambridge, England.
</P> </P>
<br><a name="SEC32" href="#TOC1">REVISION</a><br> <br><a name="SEC32" href="#TOC1">REVISION</a><br>
<P> <P>
Last updated: 28 December 2019 Last updated: 29 December 2019
<br> <br>
Copyright &copy; 1997-2019 University of Cambridge. Copyright &copy; 1997-2019 University of Cambridge.
<br> <br>

View File

@ -7671,7 +7671,9 @@ NAMED CAPTURE GROUPS
(?|(?<AA>aa)|(?<AA>bb)) (?|(?<AA>aa)|(?<AA>bb))
The duplicate name constraint can be disabled by setting the PCRE2_DUP- 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 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 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, of a weekday, either as a 3-letter abbreviation or as the full name,
@ -9488,7 +9490,7 @@ AUTHOR
REVISION REVISION
Last updated: 28 December 2019 Last updated: 29 December 2019
Copyright (c) 1997-2019 University of Cambridge. Copyright (c) 1997-2019 University of Cambridge.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------

View File

@ -1,4 +1,4 @@
.TH PCRE2PATTERN 3 "28 December 2019" "PCRE2 10.35" .TH PCRE2PATTERN 3 "29 December 2019" "PCRE2 10.35"
.SH NAME .SH NAME
PCRE2 - Perl-compatible regular expressions (revised API) PCRE2 - Perl-compatible regular expressions (revised API)
.SH "PCRE2 REGULAR EXPRESSION DETAILS" .SH "PCRE2 REGULAR EXPRESSION DETAILS"
@ -1643,6 +1643,7 @@ that succeeds is used. If the alternatives are within a group
alternative in the group. alternative in the group.
. .
. .
.\" HTML <a name="internaloptions"></a>
.SH "INTERNAL OPTION SETTING" .SH "INTERNAL OPTION SETTING"
.rs .rs
.sp .sp
@ -1901,11 +1902,19 @@ are permitted for groups with the same number, for example:
(?|(?<AA>aa)|(?<AA>bb)) (?|(?<AA>aa)|(?<AA>bb))
.sp .sp
The duplicate name constraint can be disabled by setting the PCRE2_DUPNAMES 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 option at compile time, or by the use of (?J) within the pattern, as described
names can be useful for patterns where only one instance of the named capture in the section entitiled
group can match. Suppose you want to match the name of a weekday, either as a .\" HTML <a href="#internaloptions">
3-letter abbreviation or as the full name, and in both cases you want to .\" </a>
extract the abbreviation. This pattern (ignoring the line breaks) does the job: "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 .sp
(?J) (?J)
(?<DN>Mon|Fri|Sun)(?:day)?| (?<DN>Mon|Fri|Sun)(?:day)?|
@ -3875,6 +3884,6 @@ Cambridge, England.
.rs .rs
.sp .sp
.nf .nf
Last updated: 28 December 2019 Last updated: 29 December 2019
Copyright (c) 1997-2019 University of Cambridge. Copyright (c) 1997-2019 University of Cambridge.
.fi .fi