[BACK]Return to pcretest.1 CVS log [TXT] [DIR] Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / pcre / doc

Diff for /embedaddon/pcre/doc/pcretest.1 between versions 1.1.1.2 and 1.1.1.3

version 1.1.1.2, 2012/02/21 23:50:25 version 1.1.1.3, 2012/10/09 09:19:17
Line 1 Line 1
.TH PCRETEST 1.TH PCRETEST 1 "21 February 2012" "PCRE 8.31"
 .SH NAME  .SH NAME
 pcretest - a program for testing Perl-compatible regular expressions.  pcretest - a program for testing Perl-compatible regular expressions.
 .SH SYNOPSIS  .SH SYNOPSIS
Line 129  megabytes. Line 129  megabytes.
 .TP 10  .TP 10
 \fB-s\fP or \fB-s+\fP  \fB-s\fP or \fB-s+\fP
 Behave as if each pattern has the \fB/S\fP modifier; in other words, force each  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 ispattern 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  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 aup if it is available, for both full and partial matching. Specific JIT compile
pattern (requesting output about the compiled pattern), information about theoptions can be selected by following \fB-s+\fP with a digit in the range 1 to
result of studying is not included when studying is caused only by \fB-s\fP and7, which selects the JIT compile modes as follows:
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  .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  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  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  \fB-s\fP. Output may also differ if the \fB/C\fP option is present on an
Line 316  contains multiple copies of the same substring. If the Line 331  contains multiple copies of the same substring. If the
 twice, the same action is taken for captured substrings. In each case 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  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  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  .P
 The \fB/=\fP modifier requests that the values of all potential captured  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  parentheses be output after a match. By default, only those up to the highest
Line 385  never studied, independently of \fB-s\fP. This feature Line 400  never studied, independently of \fB-s\fP. This feature
 files in a few cases where the output is different when the pattern is studied.  files in a few cases where the output is different when the pattern is studied.
 .P  .P
 If the \fB/S\fP modifier is immediately followed by a + character, the call to  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,\fBpcre[16]_study()\fP is made with all the JIT study options, requesting
requesting just-in-time optimization support if it is available. Note thatjust-in-time optimization support if it is available, for both normal and
there is also a \fB/+\fP modifier; it must not be given immediately afterpartial matching. If you want to restrict the JIT compiling modes, you can
\fB/S\fP because this will be misinterpreted. If JIT studying is successful, itfollow \fB/S+\fP with a digit in the range 1 to 7:
will automatically be used when \fBpcre[16]_exec()\fP is run, except when.sp
incompatible run-time options are specified. These include the partial matching  1  normal match only
options; a complete list is given in the  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  .\" HREF
 \fBpcrejit\fP  \fBpcrejit\fP
 .\"  .\"
Line 936  Cambridge CB2 3QH, England. Line 966  Cambridge CB2 3QH, England.
 .rs  .rs
 .sp  .sp
 .nf  .nf
Last updated: 14 January 2012Last updated: 21 February 2012
 Copyright (c) 1997-2012 University of Cambridge.  Copyright (c) 1997-2012 University of Cambridge.
 .fi  .fi
Removed from v.1.1.1.2  
changed lines
  Added in v.1.1.1.3

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>