diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/html/pcre-config.html | 2 | ||||
-rw-r--r-- | doc/html/pcre_compile.html | 4 | ||||
-rw-r--r-- | doc/html/pcre_compile2.html | 4 | ||||
-rw-r--r-- | doc/html/pcreapi.html | 6 | ||||
-rw-r--r-- | doc/html/pcrecallout.html | 2 | ||||
-rw-r--r-- | doc/html/pcrepattern.html | 2 | ||||
-rw-r--r-- | doc/html/pcreprecompile.html | 6 | ||||
-rw-r--r-- | doc/html/pcretest.html | 2 | ||||
-rw-r--r-- | doc/pcre.txt | 20 | ||||
-rw-r--r-- | doc/pcre_compile.3 | 4 | ||||
-rw-r--r-- | doc/pcre_compile2.3 | 4 | ||||
-rw-r--r-- | doc/pcreapi.3 | 6 | ||||
-rw-r--r-- | doc/pcrecallout.3 | 2 | ||||
-rw-r--r-- | doc/pcrecpp.3 | 2 | ||||
-rw-r--r-- | doc/pcrepartial.3 | 4 | ||||
-rw-r--r-- | doc/pcrepattern.3 | 2 | ||||
-rw-r--r-- | doc/pcreprecompile.3 | 6 | ||||
-rw-r--r-- | doc/pcretest.1 | 4 | ||||
-rw-r--r-- | doc/pcretest.txt | 4 |
19 files changed, 53 insertions, 33 deletions
diff --git a/doc/html/pcre-config.html b/doc/html/pcre-config.html index b227c6f..0987745 100644 --- a/doc/html/pcre-config.html +++ b/doc/html/pcre-config.html @@ -22,7 +22,7 @@ man page, in case the conversion went wrong. </ul> <br><a name="SEC1" href="#TOC1">SYNOPSIS</a><br> <P> -<b>pcre-config [--prefix] [--exec-prefix] [--version] [--libs] </b> +<b>pcre-config [--prefix] [--exec-prefix] [--version] [--libs]</b> <b>[--libs-posix] [--cflags] [--cflags-posix]</b> </P> <br><a name="SEC2" href="#TOC1">DESCRIPTION</a><br> diff --git a/doc/html/pcre_compile.html b/doc/html/pcre_compile.html index e43f9fe..3fd9a77 100644 --- a/doc/html/pcre_compile.html +++ b/doc/html/pcre_compile.html @@ -70,7 +70,9 @@ PCRE_NO_UTF8_CHECK. </P> <P> The yield of the function is a pointer to a private data structure that -contains the compiled pattern, or NULL if an error was detected. +contains the compiled pattern, or NULL if an error was detected. Note that +compiling regular expressions with one version of PCRE for use with a different +version is not guaranteed to work and may cause crashes. </P> <P> There is a complete description of the PCRE native API in the diff --git a/doc/html/pcre_compile2.html b/doc/html/pcre_compile2.html index a71c4d7..8d743c1 100644 --- a/doc/html/pcre_compile2.html +++ b/doc/html/pcre_compile2.html @@ -74,7 +74,9 @@ PCRE_NO_UTF8_CHECK. </P> <P> The yield of the function is a pointer to a private data structure that -contains the compiled pattern, or NULL if an error was detected. +contains the compiled pattern, or NULL if an error was detected. Note that +compiling regular expressions with one version of PCRE for use with a different +version is not guaranteed to work and may cause crashes. </P> <P> There is a complete description of the PCRE native API in the diff --git a/doc/html/pcreapi.html b/doc/html/pcreapi.html index 34011a8..263d26b 100644 --- a/doc/html/pcreapi.html +++ b/doc/html/pcreapi.html @@ -287,7 +287,9 @@ The compiled form of a regular expression can be saved and re-used at a later time, possibly by a different program, and even on a host other than the one on which it was compiled. Details are given in the <a href="pcreprecompile.html"><b>pcreprecompile</b></a> -documentation. +documentation. However, compiling a regular expression with one version of PCRE +for use with a different version is not guaranteed to work and may cause +crashes. </P> <br><a name="SEC6" href="#TOC1">CHECKING BUILD-TIME OPTIONS</a><br> <P> @@ -1857,7 +1859,7 @@ Cambridge CB2 3QH, England. </P> <br><a name="SEC22" href="#TOC1">REVISION</a><br> <P> -Last updated: 16 April 2007 +Last updated: 24 April 2007 <br> Copyright © 1997-2007 University of Cambridge. <br> diff --git a/doc/html/pcrecallout.html b/doc/html/pcrecallout.html index 19e457a..c87acf2 100644 --- a/doc/html/pcrecallout.html +++ b/doc/html/pcrecallout.html @@ -37,7 +37,7 @@ function is to be called. Different callout points can be identified by putting a number less than 256 after the letter C. The default value is zero. For example, this pattern has two callout points: <pre> - (?C1)\deabc(?C2)def + (?C1)abc(?C2)def </pre> If the PCRE_AUTO_CALLOUT option bit is set when <b>pcre_compile()</b> is called, PCRE automatically inserts callouts, all with number 255, before each item in diff --git a/doc/html/pcrepattern.html b/doc/html/pcrepattern.html index 6cde7ad..9e0b4cd 100644 --- a/doc/html/pcrepattern.html +++ b/doc/html/pcrepattern.html @@ -1805,7 +1805,7 @@ function is to be called. If you want to identify different callout points, you can put a number less than 256 after the letter C. The default value is zero. For example, this pattern has two callout points: <pre> - (?C1)\dabc(?C2)def + (?C1)abc(?C2)def </pre> If the PCRE_AUTO_CALLOUT flag is passed to <b>pcre_compile()</b>, callouts are automatically installed before each item in the pattern. They are all numbered diff --git a/doc/html/pcreprecompile.html b/doc/html/pcreprecompile.html index 97619b0..0e4cb74 100644 --- a/doc/html/pcreprecompile.html +++ b/doc/html/pcreprecompile.html @@ -34,7 +34,9 @@ tables, it is a little bit more complicated. If you save compiled patterns to a file, you can copy them to a different host and run them there. This works even if the new host has the opposite endianness to the one on which the patterns were compiled. There may be a small -performance penalty, but it should be insignificant. +performance penalty, but it should be insignificant. However, compiling regular +expressions with one version of PCRE for use with a different version is not +guaranteed to work and may cause crashes. </P> <br><a name="SEC2" href="#TOC1">SAVING A COMPILED PATTERN</a><br> <P> @@ -147,7 +149,7 @@ Cambridge CB2 3QH, England. </P> <br><a name="SEC6" href="#TOC1">REVISION</a><br> <P> -Last updated: 06 March 2007 +Last updated: 24 April 2007 <br> Copyright © 1997-2007 University of Cambridge. <br> diff --git a/doc/html/pcretest.html b/doc/html/pcretest.html index c041a9c..cc4269b 100644 --- a/doc/html/pcretest.html +++ b/doc/html/pcretest.html @@ -668,7 +668,7 @@ Cambridge CB2 3QH, England. </P> <br><a name="SEC15" href="#TOC1">REVISION</a><br> <P> -Last updated: 16 April 2007 +Last updated: 24 April 2007 <br> Copyright © 1997-2007 University of Cambridge. <br> diff --git a/doc/pcre.txt b/doc/pcre.txt index c15bef6..f50b1d3 100644 --- a/doc/pcre.txt +++ b/doc/pcre.txt @@ -887,7 +887,9 @@ SAVING PRECOMPILED PATTERNS FOR LATER USE The compiled form of a regular expression can be saved and re-used at a later time, possibly by a different program, and even on a host other than the one on which it was compiled. Details are given in the - pcreprecompile documentation. + pcreprecompile documentation. However, compiling a regular expression + with one version of PCRE for use with a different version is not guar- + anteed to work and may cause crashes. CHECKING BUILD-TIME OPTIONS @@ -2386,7 +2388,7 @@ AUTHOR REVISION - Last updated: 16 April 2007 + Last updated: 24 April 2007 Copyright (c) 1997-2007 University of Cambridge. ------------------------------------------------------------------------------ @@ -2414,7 +2416,7 @@ PCRE CALLOUTS default value is zero. For example, this pattern has two callout points: - (?C1)eabc(?C2)def + (?C1)abc(?C2)def If the PCRE_AUTO_CALLOUT option bit is set when pcre_compile() is called, PCRE automatically inserts callouts, all with number 255, @@ -4478,7 +4480,7 @@ EXAMPLE OF PARTIAL MATCHING USING PCRETEST using pcre_dfa_exec() matching (by means of the \D escape sequence), produces the following output: - re> /^?(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)$/ + re> /^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$/ data> 25jun04\P\D 0: 25jun04 data> 23dec3\P\D @@ -4505,7 +4507,7 @@ MULTI-SEGMENT MATCHING WITH pcre_dfa_exec() using the \R escape sequence to set the PCRE_DFA_RESTART option (\P and \D are as above): - re> /^?(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)$/ + re> /^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$/ data> 23ja\P\D Partial match: 23ja data> n05\R\D @@ -4614,7 +4616,9 @@ SAVING AND RE-USING PRECOMPILED PCRE PATTERNS ent host and run them there. This works even if the new host has the opposite endianness to the one on which the patterns were compiled. There may be a small performance penalty, but it should be insignifi- - cant. + cant. However, compiling regular expressions with one version of PCRE + for use with a different version is not guaranteed to work and may + cause crashes. SAVING A COMPILED PATTERN @@ -4721,7 +4725,7 @@ AUTHOR REVISION - Last updated: 06 March 2007 + Last updated: 24 April 2007 Copyright (c) 1997-2007 University of Cambridge. ------------------------------------------------------------------------------ @@ -5189,7 +5193,7 @@ MATCHING INTERFACE return false (because the empty string is not a valid number): int number; - pcrecpp::RE::FullMatch("abc", "[a-z]+(\d+)?", &number); + pcrecpp::RE::FullMatch("abc", "[a-z]+(\\d+)?", &number); The matching interface supports at most 16 arguments per call. If you need more, consider using the more general interface diff --git a/doc/pcre_compile.3 b/doc/pcre_compile.3 index 03e7e62..17f884e 100644 --- a/doc/pcre_compile.3 +++ b/doc/pcre_compile.3 @@ -58,7 +58,9 @@ PCRE must be built with UTF-8 support in order to use PCRE_UTF8 and PCRE_NO_UTF8_CHECK. .P The yield of the function is a pointer to a private data structure that -contains the compiled pattern, or NULL if an error was detected. +contains the compiled pattern, or NULL if an error was detected. Note that +compiling regular expressions with one version of PCRE for use with a different +version is not guaranteed to work and may cause crashes. .P There is a complete description of the PCRE native API in the .\" HREF diff --git a/doc/pcre_compile2.3 b/doc/pcre_compile2.3 index eeffdb9..1e71aff 100644 --- a/doc/pcre_compile2.3 +++ b/doc/pcre_compile2.3 @@ -62,7 +62,9 @@ PCRE must be built with UTF-8 support in order to use PCRE_UTF8 and PCRE_NO_UTF8_CHECK. .P The yield of the function is a pointer to a private data structure that -contains the compiled pattern, or NULL if an error was detected. +contains the compiled pattern, or NULL if an error was detected. Note that +compiling regular expressions with one version of PCRE for use with a different +version is not guaranteed to work and may cause crashes. .P There is a complete description of the PCRE native API in the .\" HREF diff --git a/doc/pcreapi.3 b/doc/pcreapi.3 index 035da07..0e33761 100644 --- a/doc/pcreapi.3 +++ b/doc/pcreapi.3 @@ -265,7 +265,9 @@ which it was compiled. Details are given in the .\" HREF \fBpcreprecompile\fP .\" -documentation. +documentation. However, compiling a regular expression with one version of PCRE +for use with a different version is not guaranteed to work and may cause +crashes. . . .SH "CHECKING BUILD-TIME OPTIONS" @@ -1849,6 +1851,6 @@ Cambridge CB2 3QH, England. .rs .sp .nf -Last updated: 16 April 2007 +Last updated: 24 April 2007 Copyright (c) 1997-2007 University of Cambridge. .fi diff --git a/doc/pcrecallout.3 b/doc/pcrecallout.3 index 2566c47..01cbe0e 100644 --- a/doc/pcrecallout.3 +++ b/doc/pcrecallout.3 @@ -17,7 +17,7 @@ function is to be called. Different callout points can be identified by putting a number less than 256 after the letter C. The default value is zero. For example, this pattern has two callout points: .sp - (?C1)\deabc(?C2)def + (?C1)abc(?C2)def .sp If the PCRE_AUTO_CALLOUT option bit is set when \fBpcre_compile()\fP is called, PCRE automatically inserts callouts, all with number 255, before each item in diff --git a/doc/pcrecpp.3 b/doc/pcrecpp.3 index 7745de5..ee7bb78 100644 --- a/doc/pcrecpp.3 +++ b/doc/pcrecpp.3 @@ -88,7 +88,7 @@ string is assigned the empty string. Therefore, the following will return false (because the empty string is not a valid number): .sp int number; - pcrecpp::RE::FullMatch("abc", "[a-z]+(\\d+)?", &number); + pcrecpp::RE::FullMatch("abc", "[a-z]+(\e\ed+)?", &number); .sp The matching interface supports at most 16 arguments per call. If you need more, consider using the more general interface diff --git a/doc/pcrepartial.3 b/doc/pcrepartial.3 index 19bb4ea..21008c1 100644 --- a/doc/pcrepartial.3 +++ b/doc/pcrepartial.3 @@ -99,7 +99,7 @@ pattern, but the first two are partial matches. The same test, using \fBpcre_dfa_exec()\fP matching (by means of the \eD escape sequence), produces the following output: .sp - re> /^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$/ + re> /^\ed?\ed(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\ed\ed$/ data> 25jun04\eP\eD 0: 25jun04 data> 23dec3\eP\eD @@ -126,7 +126,7 @@ space as before, because this is where details of the previous partial match are stored. Here is an example using \fBpcretest\fP, using the \eR escape sequence to set the PCRE_DFA_RESTART option (\eP and \eD are as above): .sp - re> /^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$/ + re> /^\ed?\ed(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\ed\ed$/ data> 23ja\eP\eD Partial match: 23ja data> n05\eR\eD diff --git a/doc/pcrepattern.3 b/doc/pcrepattern.3 index 60d1f1f..b53426b 100644 --- a/doc/pcrepattern.3 +++ b/doc/pcrepattern.3 @@ -1783,7 +1783,7 @@ function is to be called. If you want to identify different callout points, you can put a number less than 256 after the letter C. The default value is zero. For example, this pattern has two callout points: .sp - (?C1)\dabc(?C2)def + (?C1)abc(?C2)def .sp If the PCRE_AUTO_CALLOUT flag is passed to \fBpcre_compile()\fP, callouts are automatically installed before each item in the pattern. They are all numbered diff --git a/doc/pcreprecompile.3 b/doc/pcreprecompile.3 index 9330e50..fcc45cb 100644 --- a/doc/pcreprecompile.3 +++ b/doc/pcreprecompile.3 @@ -17,7 +17,9 @@ tables, it is a little bit more complicated. If you save compiled patterns to a file, you can copy them to a different host and run them there. This works even if the new host has the opposite endianness to the one on which the patterns were compiled. There may be a small -performance penalty, but it should be insignificant. +performance penalty, but it should be insignificant. However, compiling regular +expressions with one version of PCRE for use with a different version is not +guaranteed to work and may cause crashes. . . .SH "SAVING A COMPILED PATTERN" @@ -143,6 +145,6 @@ Cambridge CB2 3QH, England. .rs .sp .nf -Last updated: 06 March 2007 +Last updated: 24 April 2007 Copyright (c) 1997-2007 University of Cambridge. .fi diff --git a/doc/pcretest.1 b/doc/pcretest.1 index c2d2b04..5824278 100644 --- a/doc/pcretest.1 +++ b/doc/pcretest.1 @@ -537,7 +537,7 @@ indicating that the subject partially matched the pattern, you can restart the match with additional subject data by means of the \eR escape sequence. For example: .sp - re> /^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$/ + re> /^\ed?\ed(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\ed\ed$/ data> 23ja\eP\eD Partial match: 23ja data> n05\eR\eD @@ -690,6 +690,6 @@ Cambridge CB2 3QH, England. .rs .sp .nf -Last updated: 16 April 2007 +Last updated: 24 April 2007 Copyright (c) 1997-2007 University of Cambridge. .fi diff --git a/doc/pcretest.txt b/doc/pcretest.txt index 06bee98..0ba2996 100644 --- a/doc/pcretest.txt +++ b/doc/pcretest.txt @@ -488,7 +488,7 @@ RESTARTING AFTER A PARTIAL MATCH can restart the match with additional subject data by means of the \R escape sequence. For example: - re> /^?(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)$/ + re> /^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$/ data> 23ja\P\D Partial match: 23ja data> n05\R\D @@ -621,5 +621,5 @@ AUTHOR REVISION - Last updated: 16 April 2007 + Last updated: 24 April 2007 Copyright (c) 1997-2007 University of Cambridge. |