Revision: 832
http://www.exim.org/viewvc/pcre2?view=rev&revision=832
Author: ph10
Date: 2017-06-17 12:40:17 +0100 (Sat, 17 Jun 2017)
Log Message:
-----------
Documentation update.
Modified Paths:
--------------
code/trunk/doc/html/pcre2syntax.html
code/trunk/doc/pcre2.txt
code/trunk/doc/pcre2syntax.3
Modified: code/trunk/doc/html/pcre2syntax.html
===================================================================
--- code/trunk/doc/html/pcre2syntax.html 2017-06-17 11:32:06 UTC (rev 831)
+++ code/trunk/doc/html/pcre2syntax.html 2017-06-17 11:40:17 UTC (rev 832)
@@ -439,11 +439,12 @@
</pre>
The following are recognized only at the very start of a pattern or after one
of the newline or \R options with similar syntax. More than one of them may
-appear.
+appear. For the first three, d is a decimal number.
<pre>
- (*LIMIT_MATCH=d) set the match limit to d (decimal number)
- (*LIMIT_DEPTH=d) set the backtracking limit to d (decimal number)
- (*NOTEMPTY) set PCRE2_NOTEMPTY when matching
+ (*LIMIT_DEPTH=d) set the backtracking limit to d
+ (*LIMIT_HEAP=d) set the heap size limit to d kilobytes
+ (*LIMIT_MATCH=d) set the match limit to d
+ (*NOTEMPTY) set PCRE2_NOTEMPTY when matching
(*NOTEMPTY_ATSTART) set PCRE2_NOTEMPTY_ATSTART when matching
(*NO_AUTO_POSSESS) no auto-possessification (PCRE2_NO_AUTO_POSSESS)
(*NO_DOTSTAR_ANCHOR) no .* anchoring (PCRE2_NO_DOTSTAR_ANCHOR)
@@ -452,9 +453,9 @@
(*UTF) set appropriate UTF mode for the library in use
(*UCP) set PCRE2_UCP (use Unicode properties for \d etc)
</pre>
-Note that LIMIT_MATCH and LIMIT_DEPTH can only reduce the value of the limits
-set by the caller of <b>pcre2_match()</b> or <b>pcre2_dfa_match()</b>, not
-increase them. LIMIT_RECURSION is an obsolete synonym for LIMIT_DEPTH. The
+Note that LIMIT_DEPTH, LIMIT_HEAP, and LIMIT_MATCH can only reduce the value of
+the limits set by the caller of <b>pcre2_match()</b> or <b>pcre2_dfa_match()</b>,
+not increase them. LIMIT_RECURSION is an obsolete synonym for LIMIT_DEPTH. The
application can lock out the use of (*UTF) and (*UCP) by setting the
PCRE2_NEVER_UTF or PCRE2_NEVER_UCP options, respectively, at compile time.
</P>
@@ -599,7 +600,7 @@
</P>
<br><a name="SEC27" href="#TOC1">REVISION</a><br>
<P>
-Last updated: 26 May 2017
+Last updated: 17 June 2017
<br>
Copyright © 1997-2017 University of Cambridge.
<br>
Modified: code/trunk/doc/pcre2.txt
===================================================================
--- code/trunk/doc/pcre2.txt 2017-06-17 11:32:06 UTC (rev 831)
+++ code/trunk/doc/pcre2.txt 2017-06-17 11:40:17 UTC (rev 832)
@@ -9829,11 +9829,12 @@
The following are recognized only at the very start of a pattern or
after one of the newline or \R options with similar syntax. More than
- one of them may appear.
+ one of them may appear. For the first three, d is a decimal number.
- (*LIMIT_MATCH=d) set the match limit to d (decimal number)
- (*LIMIT_DEPTH=d) set the backtracking limit to d (decimal number)
- (*NOTEMPTY) set PCRE2_NOTEMPTY when matching
+ (*LIMIT_DEPTH=d) set the backtracking limit to d
+ (*LIMIT_HEAP=d) set the heap size limit to d kilobytes
+ (*LIMIT_MATCH=d) set the match limit to d
+ (*NOTEMPTY) set PCRE2_NOTEMPTY when matching
(*NOTEMPTY_ATSTART) set PCRE2_NOTEMPTY_ATSTART when matching
(*NO_AUTO_POSSESS) no auto-possessification (PCRE2_NO_AUTO_POSSESS)
(*NO_DOTSTAR_ANCHOR) no .* anchoring (PCRE2_NO_DOTSTAR_ANCHOR)
@@ -9842,12 +9843,12 @@
(*UTF) set appropriate UTF mode for the library in use
(*UCP) set PCRE2_UCP (use Unicode properties for \d etc)
- Note that LIMIT_MATCH and LIMIT_DEPTH can only reduce the value of the
- limits set by the caller of pcre2_match() or pcre2_dfa_match(), not
- increase them. LIMIT_RECURSION is an obsolete synonym for LIMIT_DEPTH.
- The application can lock out the use of (*UTF) and (*UCP) by setting
- the PCRE2_NEVER_UTF or PCRE2_NEVER_UCP options, respectively, at com-
- pile time.
+ Note that LIMIT_DEPTH, LIMIT_HEAP, and LIMIT_MATCH can only reduce the
+ value of the limits set by the caller of pcre2_match() or
+ pcre2_dfa_match(), not increase them. LIMIT_RECURSION is an obsolete
+ synonym for LIMIT_DEPTH. The application can lock out the use of (*UTF)
+ and (*UCP) by setting the PCRE2_NEVER_UTF or PCRE2_NEVER_UCP options,
+ respectively, at compile time.
NEWLINE CONVENTION
@@ -9989,7 +9990,7 @@
REVISION
- Last updated: 26 May 2017
+ Last updated: 17 June 2017
Copyright (c) 1997-2017 University of Cambridge.
------------------------------------------------------------------------------
Modified: code/trunk/doc/pcre2syntax.3
===================================================================
--- code/trunk/doc/pcre2syntax.3 2017-06-17 11:32:06 UTC (rev 831)
+++ code/trunk/doc/pcre2syntax.3 2017-06-17 11:40:17 UTC (rev 832)
@@ -1,4 +1,4 @@
-.TH PCRE2SYNTAX 3 "26 May 2017" "PCRE2 10.30"
+.TH PCRE2SYNTAX 3 "17 June 2017" "PCRE2 10.30"
.SH NAME
PCRE2 - Perl-compatible regular expressions (revised API)
.SH "PCRE2 REGULAR EXPRESSION SYNTAX SUMMARY"
@@ -416,11 +416,12 @@
.sp
The following are recognized only at the very start of a pattern or after one
of the newline or \eR options with similar syntax. More than one of them may
-appear.
+appear. For the first three, d is a decimal number.
.sp
- (*LIMIT_MATCH=d) set the match limit to d (decimal number)
- (*LIMIT_DEPTH=d) set the backtracking limit to d (decimal number)
- (*NOTEMPTY) set PCRE2_NOTEMPTY when matching
+ (*LIMIT_DEPTH=d) set the backtracking limit to d
+ (*LIMIT_HEAP=d) set the heap size limit to d kilobytes
+ (*LIMIT_MATCH=d) set the match limit to d
+ (*NOTEMPTY) set PCRE2_NOTEMPTY when matching
(*NOTEMPTY_ATSTART) set PCRE2_NOTEMPTY_ATSTART when matching
(*NO_AUTO_POSSESS) no auto-possessification (PCRE2_NO_AUTO_POSSESS)
(*NO_DOTSTAR_ANCHOR) no .* anchoring (PCRE2_NO_DOTSTAR_ANCHOR)
@@ -429,9 +430,9 @@
(*UTF) set appropriate UTF mode for the library in use
(*UCP) set PCRE2_UCP (use Unicode properties for \ed etc)
.sp
-Note that LIMIT_MATCH and LIMIT_DEPTH can only reduce the value of the limits
-set by the caller of \fBpcre2_match()\fP or \fBpcre2_dfa_match()\fP, not
-increase them. LIMIT_RECURSION is an obsolete synonym for LIMIT_DEPTH. The
+Note that LIMIT_DEPTH, LIMIT_HEAP, and LIMIT_MATCH can only reduce the value of
+the limits set by the caller of \fBpcre2_match()\fP or \fBpcre2_dfa_match()\fP,
+not increase them. LIMIT_RECURSION is an obsolete synonym for LIMIT_DEPTH. The
application can lock out the use of (*UTF) and (*UCP) by setting the
PCRE2_NEVER_UTF or PCRE2_NEVER_UCP options, respectively, at compile time.
.
@@ -588,6 +589,6 @@
.rs
.sp
.nf
-Last updated: 26 May 2017
+Last updated: 17 June 2017
Copyright (c) 1997-2017 University of Cambridge.
.fi
