--- embedaddon/pcre/doc/pcretest.1 2012/02/21 23:50:25 1.1.1.2 +++ embedaddon/pcre/doc/pcretest.1 2012/10/09 09:19:17 1.1.1.3 @@ -1,4 +1,4 @@ -.TH PCRETEST 1 +.TH PCRETEST 1 "21 February 2012" "PCRE 8.31" .SH NAME pcretest - a program for testing Perl-compatible regular expressions. .SH SYNOPSIS @@ -129,16 +129,31 @@ megabytes. .TP 10 \fB-s\fP or \fB-s+\fP Behave as if each pattern has the \fB/S\fP modifier; in other words, force each -pattern to be studied. If \fB-s+\fP is used, the PCRE_STUDY_JIT_COMPILE flag is +pattern to be studied. If \fB-s+\fP is used, all the JIT compile options are passed to \fBpcre[16]_study()\fP, causing just-in-time optimization to be set -up if it is available. If the \fB/I\fP or \fB/D\fP option is present on a -pattern (requesting output about the compiled pattern), information about the -result of studying is not included when studying is caused only by \fB-s\fP and -neither \fB-i\fP nor \fB-d\fP is present on the command line. This behaviour -means that the output from tests that are run with and without \fB-s\fP should -be identical, except when options that output information about the actual -running of a match are set. +up if it is available, for both full and partial matching. Specific JIT compile +options can be selected by following \fB-s+\fP with a digit in the range 1 to +7, which selects the JIT compile modes as follows: .sp + 1 normal match only + 2 soft partial match only + 3 normal match and soft partial match + 4 hard partial match only + 6 soft and hard partial match + 7 all three modes (default) +.sp +If \fB-s++\fP is used instead of \fB-s+\fP (with or without a following digit), +the text "(JIT)" is added to the first output line after a match or no match +when JIT-compiled code was actually used. +.P +If the \fB/I\fP or \fB/D\fP option is present on a pattern (requesting output +about the compiled pattern), information about the result of studying is not +included when studying is caused only by \fB-s\fP and neither \fB-i\fP nor +\fB-d\fP is present on the command line. This behaviour means that the output +from tests that are run with and without \fB-s\fP should be identical, except +when options that output information about the actual running of a match are +set. +.sp The \fB-M\fP, \fB-t\fP, and \fB-tm\fP options, which give information about resources used, are likely to produce different output with and without \fB-s\fP. Output may also differ if the \fB/C\fP option is present on an @@ -316,7 +331,7 @@ contains multiple copies of the same substring. If the twice, the same action is taken for captured substrings. In each case the remainder is output on the following line with a plus character following the capture number. Note that this modifier must not immediately follow the /S -modifier because /S+ has another meaning. +modifier because /S+ and /S++ have other meanings. .P The \fB/=\fP modifier requests that the values of all potential captured parentheses be output after a match. By default, only those up to the highest @@ -385,13 +400,28 @@ never studied, independently of \fB-s\fP. This feature files in a few cases where the output is different when the pattern is studied. .P If the \fB/S\fP modifier is immediately followed by a + character, the call to -\fBpcre[16]_study()\fP is made with the PCRE_STUDY_JIT_COMPILE option, -requesting just-in-time optimization support if it is available. Note that -there is also a \fB/+\fP modifier; it must not be given immediately after -\fB/S\fP because this will be misinterpreted. If JIT studying is successful, it -will automatically be used when \fBpcre[16]_exec()\fP is run, except when -incompatible run-time options are specified. These include the partial matching -options; a complete list is given in the +\fBpcre[16]_study()\fP is made with all the JIT study options, requesting +just-in-time optimization support if it is available, for both normal and +partial matching. If you want to restrict the JIT compiling modes, you can +follow \fB/S+\fP with a digit in the range 1 to 7: +.sp + 1 normal match only + 2 soft partial match only + 3 normal match and soft partial match + 4 hard partial match only + 6 soft and hard partial match + 7 all three modes (default) +.sp +If \fB/S++\fP is used instead of \fB/S+\fP (with or without a following digit), +the text "(JIT)" is added to the first output line after a match or no match +when JIT-compiled code was actually used. +.P +Note that there is also an independent \fB/+\fP modifier; it must not be given +immediately after \fB/S\fP or \fB/S+\fP because this will be misinterpreted. +.P +If JIT studying is successful, the compiled JIT code will automatically be used +when \fBpcre[16]_exec()\fP is run, except when incompatible run-time options +are specified. For more details, see the .\" HREF \fBpcrejit\fP .\" @@ -936,6 +966,6 @@ Cambridge CB2 3QH, England. .rs .sp .nf -Last updated: 14 January 2012 +Last updated: 21 February 2012 Copyright (c) 1997-2012 University of Cambridge. .fi