Revision: 1256
http://vcs.pcre.org/viewvc?view=rev&revision=1256
Author: ph10
Date: 2013-02-22 17:16:28 +0000 (Fri, 22 Feb 2013)
Log Message:
-----------
Document exit codes from pcretest when -C is used.
Modified Paths:
--------------
code/trunk/doc/pcretest.1
Modified: code/trunk/doc/pcretest.1
===================================================================
--- code/trunk/doc/pcretest.1 2013-02-22 12:55:01 UTC (rev 1255)
+++ code/trunk/doc/pcretest.1 2013-02-22 17:16:28 UTC (rev 1256)
@@ -1,4 +1,4 @@
-.TH PCRETEST 1 "10 September 2012" "PCRE 8.32"
+.TH PCRETEST 1 "22 February 2013" "PCRE 8.33"
.SH NAME
pcretest - a program for testing Perl-compatible regular expressions.
.SH SYNOPSIS
@@ -85,22 +85,26 @@
.TP 10
\fB-C\fP
Output the version number of the PCRE library, and all available information
-about the optional features that are included, and then exit. All other options
-are ignored.
+about the optional features that are included, and then exit with zero exit
+code. All other options are ignored.
.TP 10
\fB-C\fP \fIoption\fP
Output information about a specific build-time option, then exit. This
functionality is intended for use in scripts such as \fBRunTest\fP. The
-following options output the value indicated:
+following options output the value and set the exit code as indicated:
.sp
ebcdic-nl the code for LF (= NL) in an EBCDIC environment:
0x15 or 0x25
0 if used in an ASCII environment
- linksize the internal link size (2, 3, or 4)
+ exit code is always 0
+ linksize the configured internal link size (2, 3, or 4)
+ exit code is set to the link size
newline the default newline setting:
CR, LF, CRLF, ANYCRLF, or ANY
+ exit code is always 0
.sp
-The following options output 1 for true or zero for false:
+The following options output 1 for true or 0 for false, and set the exit code
+to the same value:
.sp
ebcdic compiled for an EBCDIC environment
jit just-in-time support is available
@@ -108,7 +112,10 @@
pcre32 the 32-bit library was built
pcre8 the 8-bit library was built
ucp Unicode property support is available
- utf UTF-8 and/or UTF-16 and/or UTF-32 support is available
+ utf UTF-8 and/or UTF-16 and/or UTF-32 support
+ is available
+.sp
+If an unknown option is given, an error message is output; the exit code is 0.
.TP 10
\fB-d\fP
Behave as if each pattern has the \fB/D\fP (debug) modifier; the internal
@@ -1074,6 +1081,6 @@
.rs
.sp
.nf
-Last updated: 10 September 2012
-Copyright (c) 1997-2012 University of Cambridge.
+Last updated: 22 February 2013
+Copyright (c) 1997-2013 University of Cambridge.
.fi