/[pcre]/code/trunk/doc/pcretest.1

Diff of /code/trunk/doc/pcretest.1

Parent Directory | Revision Log | View Patch Patch

-revision 461 by ph10,
Mon Oct  5 10:59:35 2009 UTC
+revision 510 by ph10,
Sat Mar 27 17:45:29 2010 UTC
 Line 224 
 such cases when using the \fB/g\fP modif
  There are yet more modifiers for controlling the way \fBpcretest\fP
  operates.
  .P
+ The \fB/8\fP modifier causes \fBpcretest\fP to call PCRE with the PCRE_UTF8
+ option set. This turns on support for UTF-8 character handling in PCRE,
+ provided that it was compiled with this support enabled. This modifier also
+ causes any non-printing characters in output strings to be printed using the
+ \ex{hh...} notation if they are valid UTF-8 sequences.
+ .P
+ If the \fB/?\fP modifier is used with \fB/8\fP, it causes \fBpcretest\fP to
+ call \fBpcre_compile()\fP with the PCRE_NO_UTF8_CHECK option, to suppress the
+ checking of the string for UTF-8 validity.
+ .P
  The \fB/+\fP modifier requests that as well as outputting the substring that
  matched the entire pattern, pcretest should in addition output the remainder of
  the subject string. This is useful for tests where the subject contains
-Line 236 
 also present, this data is replaced by s
+Line 246 
 also present, this data is replaced by s
  use in the automatic test scripts; it ensures that the same output is generated
  for different internal link sizes.
  .P
- The \fB/L\fP modifier must be followed directly by the name of a locale, for
- example,
- .sp
-   /pattern/Lfr_FR
- .sp
- For this reason, it must be the last modifier. The given locale is set,
- \fBpcre_maketables()\fP is called to build a set of character tables for the
- locale, and this is then passed to \fBpcre_compile()\fP when compiling the
- regular expression. Without an \fB/L\fP modifier, NULL is passed as the tables
- pointer; that is, \fB/L\fP applies only to the expression on which it appears.
- .P
- The \fB/I\fP modifier requests that \fBpcretest\fP output information about the
- compiled pattern (whether it is anchored, has a fixed first character, and
- so on). It does this by calling \fBpcre_fullinfo()\fP after compiling a
- pattern. If the pattern is studied, the results of that are also output.
- .P
  The \fB/D\fP modifier is a PCRE debugging feature, and is equivalent to
  \fB/BI\fP, that is, both the \fB/B\fP and the \fB/I\fP modifiers.
  .P
-Line 263 
 available when the POSIX interface to PC
+Line 257 
 available when the POSIX interface to PC
  \fB/P\fP pattern modifier is specified. See also the section about saving and
  reloading compiled patterns below.
  .P
- The \fB/S\fP modifier causes \fBpcre_study()\fP to be called after the
+ The \fB/I\fP modifier requests that \fBpcretest\fP output information about the
- expression has been compiled, and the results used when the expression is
+ compiled pattern (whether it is anchored, has a fixed first character, and
- matched.
+ so on). It does this by calling \fBpcre_fullinfo()\fP after compiling a
+ pattern. If the pattern is studied, the results of that are also output.
+ .P
+ The \fB/K\fP modifier requests \fBpcretest\fP to show names from backtracking
+ control verbs that are returned from calls to \fBpcre_exec()\fP. It causes
+ \fBpcretest\fP to create a \fBpcre_extra\fP block if one has not already been
+ created by a call to \fBpcre_study()\fP, and to set the PCRE_EXTRA_MARK flag
+ and the \fBmark\fP field within it, every time that \fBpcre_exec()\fP is
+ called. If the variable that the \fBmark\fP field points to is non-NULL for a
+ match, non-match, or partial match, \fBpcretest\fP prints the string to which
+ it points. For a match, this is shown on a line by itself, tagged with "MK:".
+ For a non-match it is added to the message.
+ .P
+ The \fB/L\fP modifier must be followed directly by the name of a locale, for
+ example,
+ .sp
+   /pattern/Lfr_FR
+ .sp
+ For this reason, it must be the last modifier. The given locale is set,
+ \fBpcre_maketables()\fP is called to build a set of character tables for the
+ locale, and this is then passed to \fBpcre_compile()\fP when compiling the
+ regular expression. Without an \fB/L\fP modifier, NULL is passed as the tables
+ pointer; that is, \fB/L\fP applies only to the expression on which it appears.
  .P
  The \fB/M\fP modifier causes the size of memory block used to hold the compiled
  pattern to be output.
-Line 276 
 API rather than its native API. When thi
+Line 292 
 API rather than its native API. When thi
  present, and REG_NEWLINE is set if \fB/m\fP is present. The wrapper functions
  force PCRE_DOLLAR_ENDONLY always, and PCRE_DOTALL unless REG_NEWLINE is set.
  .P
- The \fB/8\fP modifier causes \fBpcretest\fP to call PCRE with the PCRE_UTF8
+ The \fB/S\fP modifier causes \fBpcre_study()\fP to be called after the
- option set. This turns on support for UTF-8 character handling in PCRE,
+ expression has been compiled, and the results used when the expression is
- provided that it was compiled with this support enabled. This modifier also
+ matched.
- causes any non-printing characters in output strings to be printed using the
- \ex{hh...} notation if they are valid UTF-8 sequences.
- .P
- If the \fB/?\fP modifier is used with \fB/8\fP, it causes \fBpcretest\fP to
- call \fBpcre_compile()\fP with the PCRE_NO_UTF8_CHECK option, to suppress the
- checking of the string for UTF-8 validity.
  .
  .
  .SH "DATA LINES"
-Line 731 
 Cambridge CB2 3QH, England.
+Line 741 
 Cambridge CB2 3QH, England.
  .rs
  .sp
  .nf
- Last updated: 26 September 2009
+ Last updated: 26 March 2010
- Copyright (c) 1997-2009 University of Cambridge.
+ Copyright (c) 1997-2010 University of Cambridge.
  .fi

 Legend:



Removed from v.461
 


changed lines


 
Added in v.510
 Legend:



Removed from v.461
 


changed lines


 
Added in v.510
-Removed from v.461
+Added in v.510

	ViewVC Help
Powered by ViewVC 1.1.5