Revision: 1307
http://www.exim.org/viewvc/pcre2?view=rev&revision=1307
Author: ph10
Date: 2021-04-28 15:21:38 +0100 (Wed, 28 Apr 2021)
Log Message:
-----------
Documentation and tests update.
Modified Paths:
--------------
code/trunk/doc/pcre2.3
code/trunk/doc/pcre2test.1
code/trunk/testdata/testinput2
code/trunk/testdata/testoutput2
Modified: code/trunk/doc/pcre2.3
===================================================================
--- code/trunk/doc/pcre2.3 2021-04-27 08:36:47 UTC (rev 1306)
+++ code/trunk/doc/pcre2.3 2021-04-28 14:21:38 UTC (rev 1307)
@@ -1,4 +1,4 @@
-.TH PCRE2 3 "17 September 2018" "PCRE2 10.33"
+.TH PCRE2 3 "28 April 2021" "PCRE2 10.37"
.SH NAME
PCRE2 - Perl-compatible regular expressions (revised API)
.SH INTRODUCTION
@@ -19,8 +19,13 @@
Oniguruma syntax items, and there are options for requesting some minor changes
that give better ECMAScript (aka JavaScript) compatibility.
.P
-The source code for PCRE2 can be compiled to support 8-bit, 16-bit, or 32-bit
-code units, which means that up to three separate libraries may be installed.
+The source code for PCRE2 can be compiled to support strings of 8-bit, 16-bit,
+or 32-bit code units, which means that up to three separate libraries may be
+installed, one for each code unit size. The size of code unit is not related to
+the bit size of the underlying hardware. In a 64-bit environment that also
+supports 32-bit applications, versions of PCRE2 that are compiled in both
+64-bit and 32-bit modes may be needed.
+.P
The original work to extend PCRE to 16-bit and 32-bit code units was done by
Zoltan Herczeg and Christian Persch, respectively. In all three cases, strings
can be interpreted either as one character per code unit, or as UTF-encoded
@@ -197,6 +202,6 @@
.rs
.sp
.nf
-Last updated: 17 September 2018
-Copyright (c) 1997-2018 University of Cambridge.
+Last updated: 28 April 2021
+Copyright (c) 1997-2021 University of Cambridge.
.fi
Modified: code/trunk/doc/pcre2test.1
===================================================================
--- code/trunk/doc/pcre2test.1 2021-04-27 08:36:47 UTC (rev 1306)
+++ code/trunk/doc/pcre2test.1 2021-04-28 14:21:38 UTC (rev 1307)
@@ -1,4 +1,4 @@
-.TH PCRE2TEST 1 "14 September 2020" "PCRE 10.36"
+.TH PCRE2TEST 1 "28 April 2021" "PCRE 10.37"
.SH NAME
pcre2test - a program for testing Perl-compatible regular expressions.
.SH SYNOPSIS
@@ -1180,7 +1180,7 @@
The following modifiers affect the matching process or request additional
information. Some of them may also be specified on a pattern line (see above),
in which case they apply to every subject line that is matched against that
-pattern.
+pattern, but can be overridden by modifiers on the subject.
.sp
aftertext show text after match
allaftertext show text after captures
@@ -1389,6 +1389,10 @@
replacement strings cannot contain commas, because a comma signifies the end of
a modifier. This is not thought to be an issue in a test program.
.P
+Specifying a completely empty replacement string disables this modifier.
+However, it is possible to specify an empty replacement by providing a buffer
+length, as described below, for an otherwise empty replacement.
+.P
Unlike subject strings, \fBpcre2test\fP does not process replacement strings
for escape sequences. In UTF mode, a replacement string is checked to see if it
is a valid UTF-8 string. If so, it is correctly converted to a UTF string of
@@ -2101,6 +2105,6 @@
.rs
.sp
.nf
-Last updated: 14 September 2020
-Copyright (c) 1997-2020 University of Cambridge.
+Last updated: 28 April 2021
+Copyright (c) 1997-2021 University of Cambridge.
.fi
Modified: code/trunk/testdata/testinput2
===================================================================
--- code/trunk/testdata/testinput2 2021-04-27 08:36:47 UTC (rev 1306)
+++ code/trunk/testdata/testinput2 2021-04-28 14:21:38 UTC (rev 1307)
@@ -5830,7 +5830,20 @@
/55|a(..)d/g,replace=>$1<
xyz55abcdxyzabcdxyz\=ovector=2,substitute_unset_empty
+
+/abc/replace=,caseless
+ XabcY
+ XABCY
+/abc/replace=[4],caseless
+ XabcY
+ XABCY
+
+/abc/replace=*,caseless
+ XabcY
+ XABCY
+ XabcY\=replace=
+
# Expect non-fixed-length error
"(?<=X(?(DEFINE)(.*))(?1))."
Modified: code/trunk/testdata/testoutput2
===================================================================
--- code/trunk/testdata/testoutput2 2021-04-27 08:36:47 UTC (rev 1306)
+++ code/trunk/testdata/testoutput2 2021-04-28 14:21:38 UTC (rev 1307)
@@ -17571,7 +17571,27 @@
/55|a(..)d/g,replace=>$1<
xyz55abcdxyzabcdxyz\=ovector=2,substitute_unset_empty
3: xyz><>bc<xyz>bc<xyz
+
+/abc/replace=,caseless
+ XabcY
+ 0: abc
+ XABCY
+ 0: ABC
+/abc/replace=[4],caseless
+ XabcY
+ 1: XY
+ XABCY
+ 1: XY
+
+/abc/replace=*,caseless
+ XabcY
+ 1: X*Y
+ XABCY
+ 1: X*Y
+ XabcY\=replace=
+ 0: abc
+
# Expect non-fixed-length error
"(?<=X(?(DEFINE)(.*))(?1))."
