Documentation update.

git-svn-id: svn://vcs.exim.org/pcre2/code/trunk@1199 6239d852-aaf2-0410-a92c-79f79f948069

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
 <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 @@ are permitted for groups with the same number, for example:
   (?|(?&#60;AA&#62;aa)|(?&#60;AA&#62;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)
   (?&#60;DN&#62;Mon|Fri|Sun)(?:day)?|
@@ -3834,7 +3840,7 @@ Cambridge, England.
 </P>
 <br><a name="SEC32" href="#TOC1">REVISION</a><br>
 <P>
-Last updated: 28 December 2019
+Last updated: 29 December 2019
 <br>
 Copyright &copy; 1997-2019 University of Cambridge.
 <br>
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>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 @@ 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 <a name="internaloptions"></a>
 .SH "INTERNAL OPTION SETTING"
 .rs
 .sp
@@ -1901,11 +1902,19 @@ are permitted for groups with the same number, for example:
   (?|(?<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 @@ Cambridge, England.
 .rs
 .sp
 .nf
-Last updated: 28 December 2019
+Last updated: 29 December 2019
 Copyright (c) 1997-2019 University of Cambridge.
 .fi