From 279128cbdedcbd229572307b254efc350a1db1d4 Mon Sep 17 00:00:00 2001 From: "Philip.Hazel" Date: Sun, 29 Dec 2019 11:44:51 +0000 Subject: [PATCH] Documentation update. --- doc/html/pcre2pattern.html | 20 +++++++++++++------- doc/pcre2.txt | 6 ++++-- doc/pcre2pattern.3 | 23 ++++++++++++++++------- 3 files changed, 33 insertions(+), 16 deletions(-) diff --git a/doc/html/pcre2pattern.html b/doc/html/pcre2pattern.html index d201cf2..4811d82 100644 --- a/doc/html/pcre2pattern.html +++ b/doc/html/pcre2pattern.html @@ -1650,7 +1650,7 @@ that succeeds is used. If the alternatives are within a group (defined below), "succeeds" means matching the rest of the main pattern as well as the alternative in the group. -

+


INTERNAL OPTION SETTING

The settings of the PCRE2_CASELESS, PCRE2_MULTILINE, PCRE2_DOTALL, @@ -1901,11 +1901,17 @@ are permitted for groups with the same number, for example: (?|(?<AA>aa)|(?<AA>bb)) 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 +"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, and in both cases you +want to extract the abbreviation. This pattern (ignoring the line breaks) does +the job: 

   (?J)
   (?<DN>Mon|Fri|Sun)(?:day)?|
@@ -3834,7 +3840,7 @@ Cambridge, England.
 

 
REVISION

 

-Last updated: 28 December 2019
+Last updated: 29 December 2019
 

 Copyright © 1997-2019 University of Cambridge.
 

diff --git a/doc/pcre2.txt b/doc/pcre2.txt
index 7af1916..91020ef 100644
--- a/doc/pcre2.txt
+++ b/doc/pcre2.txt
@@ -7671,7 +7671,9 @@ NAMED CAPTURE GROUPS
          (?|(?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 @@ AUTHOR
 
 REVISION
 
-       Last updated: 28 December 2019
+       Last updated: 29 December 2019
        Copyright (c) 1997-2019 University of Cambridge.
 ------------------------------------------------------------------------------
  
diff --git a/doc/pcre2pattern.3 b/doc/pcre2pattern.3
index 9430c6b..df95f5e 100644
--- a/doc/pcre2pattern.3
+++ b/doc/pcre2pattern.3
@@ -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 @@ that succeeds is used. If the alternatives are within a group
 alternative in the group.
 .
 .
+.\" HTML 
 .SH "INTERNAL OPTION SETTING"
 .rs
 .sp
@@ -1901,11 +1902,19 @@ are permitted for groups with the same number, for example:
   (?|(?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 
+.\" 
+"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)
   (?Mon|Fri|Sun)(?:day)?|
@@ -3875,6 +3884,6 @@ Cambridge, England.
 .rs
 .sp
 .nf
-Last updated: 28 December 2019
+Last updated: 29 December 2019
 Copyright (c) 1997-2019 University of Cambridge.
 .fi