You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by pg...@apache.org on 2007/11/26 17:50:09 UTC
svn commit: r598339 [16/37] - in /httpd/httpd/vendor/pcre/current: ./ doc/
doc/html/ testdata/
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_compile.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_compile.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_compile.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_compile.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_COMPILE 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B pcre *pcre_compile(const char *\fIpattern\fP, int \fIoptions\fP,
.ti +5n
.B const char **\fIerrptr\fP, int *\fIerroffset\fP,
@@ -17,8 +16,9 @@
.SH DESCRIPTION
.rs
.sp
-This function compiles a regular expression into an internal form. Its
-arguments are:
+This function compiles a regular expression into an internal form. It is the
+same as \fBpcre_compile2()\fP, except for the absence of the \fIerrorcodeptr\fP
+argument. Its arguments are:
.sp
\fIpattern\fR A zero-terminated string containing the
regular expression to be compiled
@@ -32,13 +32,22 @@
.sp
PCRE_ANCHORED Force pattern anchoring
PCRE_AUTO_CALLOUT Compile automatic callouts
+ PCRE_BSR_ANYCRLF \eR matches only CR, LF, or CRLF
+ PCRE_BSR_UNICODE \eR matches all Unicode line endings
PCRE_CASELESS Do caseless matching
PCRE_DOLLAR_ENDONLY $ not to match newline at end
PCRE_DOTALL . matches anything including NL
+ PCRE_DUPNAMES Allow duplicate names for subpatterns
PCRE_EXTENDED Ignore whitespace and # comments
PCRE_EXTRA PCRE extra features
(not much use currently)
+ PCRE_FIRSTLINE Force matching to be before newline
PCRE_MULTILINE ^ and $ match newlines within data
+ PCRE_NEWLINE_ANY Recognize any Unicode newline sequence
+ PCRE_NEWLINE_ANYCRLF Recognize CR, LF, and CRLF as newline sequences
+ PCRE_NEWLINE_CR Set CR as the newline sequence
+ PCRE_NEWLINE_CRLF Set CRLF as the newline sequence
+ PCRE_NEWLINE_LF Set LF as the newline sequence
PCRE_NO_AUTO_CAPTURE Disable numbered capturing paren-
theses (named ones available)
PCRE_UNGREEDY Invert greediness of quantifiers
@@ -51,7 +60,9 @@
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
Added: httpd/httpd/vendor/pcre/current/doc/pcre_compile2.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_compile2.3?rev=598339&view=auto
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_compile2.3 (added)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_compile2.3 Mon Nov 26 08:49:53 2007
@@ -0,0 +1,77 @@
+.TH PCRE_COMPILE2 3
+.SH NAME
+PCRE - Perl-compatible regular expressions
+.SH SYNOPSIS
+.rs
+.sp
+.B #include <pcre.h>
+.PP
+.SM
+.B pcre *pcre_compile2(const char *\fIpattern\fP, int \fIoptions\fP,
+.ti +5n
+.B int *\fIerrorcodeptr\fP,
+.ti +5n
+.B const char **\fIerrptr\fP, int *\fIerroffset\fP,
+.ti +5n
+.B const unsigned char *\fItableptr\fP);
+.
+.SH DESCRIPTION
+.rs
+.sp
+This function compiles a regular expression into an internal form. It is the
+same as \fBpcre_compile()\fP, except for the addition of the \fIerrorcodeptr\fP
+argument. The arguments are:
+
+.sp
+ \fIpattern\fR A zero-terminated string containing the
+ regular expression to be compiled
+ \fIoptions\fR Zero or more option bits
+ \fIerrorcodeptr\fP Where to put an error code
+ \fIerrptr\fR Where to put an error message
+ \fIerroffset\fR Offset in pattern where error was found
+ \fItableptr\fR Pointer to character tables, or NULL to
+ use the built-in default
+.sp
+The option bits are:
+.sp
+ PCRE_ANCHORED Force pattern anchoring
+ PCRE_AUTO_CALLOUT Compile automatic callouts
+ PCRE_CASELESS Do caseless matching
+ PCRE_DOLLAR_ENDONLY $ not to match newline at end
+ PCRE_DOTALL . matches anything including NL
+ PCRE_DUPNAMES Allow duplicate names for subpatterns
+ PCRE_EXTENDED Ignore whitespace and # comments
+ PCRE_EXTRA PCRE extra features
+ (not much use currently)
+ PCRE_FIRSTLINE Force matching to be before newline
+ PCRE_MULTILINE ^ and $ match newlines within data
+ PCRE_NEWLINE_ANY Recognize any Unicode newline sequence
+ PCRE_NEWLINE_ANYCRLF Recognize CR, LF, and CRLF as newline sequences
+ PCRE_NEWLINE_CR Set CR as the newline sequence
+ PCRE_NEWLINE_CRLF Set CRLF as the newline sequence
+ PCRE_NEWLINE_LF Set LF as the newline sequence
+ PCRE_NO_AUTO_CAPTURE Disable numbered capturing paren-
+ theses (named ones available)
+ PCRE_UNGREEDY Invert greediness of quantifiers
+ PCRE_UTF8 Run in UTF-8 mode
+ PCRE_NO_UTF8_CHECK Do not check the pattern for UTF-8
+ validity (only relevant if
+ PCRE_UTF8 is set)
+.sp
+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. 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
+\fBpcreapi\fR
+.\"
+page and a description of the POSIX API in the
+.\" HREF
+\fBpcreposix\fR
+.\"
+page.
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_config.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_config.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_config.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_config.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_CONFIG 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_config(int \fIwhat\fP, void *\fIwhere\fP);
.
.SH DESCRIPTION
@@ -24,7 +23,17 @@
.sp
PCRE_CONFIG_LINK_SIZE Internal link size: 2, 3, or 4
PCRE_CONFIG_MATCH_LIMIT Internal resource limit
- PCRE_CONFIG_NEWLINE Value of the newline character
+ PCRE_CONFIG_MATCH_LIMIT_RECURSION
+ Internal recursion depth limit
+ PCRE_CONFIG_NEWLINE Value of the default newline sequence:
+ 13 (0x000d) for CR
+ 10 (0x000a) for LF
+ 3338 (0x0d0a) for CRLF
+ -2 for ANYCRLF
+ -1 for ANY
+ PCRE_CONFIG_BSR Indicates what \eR matches by default:
+ 0 all Unicode line endings
+ 1 CR, LF, or CRLF only
PCRE_CONFIG_POSIX_MALLOC_THRESHOLD
Threshold of return slots, above
which \fBmalloc()\fR is used by
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_copy_named_substring.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_copy_named_substring.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_copy_named_substring.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_copy_named_substring.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_COPY_NAMED_SUBSTRING 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_copy_named_substring(const pcre *\fIcode\fP,
.ti +5n
.B const char *\fIsubject\fP, int *\fIovector\fP,
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_copy_substring.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_copy_substring.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_copy_substring.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_copy_substring.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_COPY_SUBSTRING 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_copy_substring(const char *\fIsubject\fP, int *\fIovector\fP,
.ti +5n
.B int \fIstringcount\fP, int \fIstringnumber\fP, char *\fIbuffer\fP,
@@ -27,7 +26,7 @@
\fIbuffer\fP Buffer to receive the string
\fIbuffersize\fP Size of buffer
.sp
-The yield is the legnth of the string, PCRE_ERROR_NOMEMORY if the buffer was
+The yield is the length of the string, PCRE_ERROR_NOMEMORY if the buffer was
too small, or PCRE_ERROR_NOSUBSTRING if the string number is invalid.
.P
There is a complete description of the PCRE native API in the
Added: httpd/httpd/vendor/pcre/current/doc/pcre_dfa_exec.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_dfa_exec.3?rev=598339&view=auto
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_dfa_exec.3 (added)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_dfa_exec.3 Mon Nov 26 08:49:53 2007
@@ -0,0 +1,88 @@
+.TH PCRE_DFA_EXEC 3
+.SH NAME
+PCRE - Perl-compatible regular expressions
+.SH SYNOPSIS
+.rs
+.sp
+.B #include <pcre.h>
+.PP
+.SM
+.B int pcre_dfa_exec(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP,"
+.ti +5n
+.B "const char *\fIsubject\fP," int \fIlength\fP, int \fIstartoffset\fP,
+.ti +5n
+.B int \fIoptions\fP, int *\fIovector\fP, int \fIovecsize\fP,
+.ti +5n
+.B int *\fIworkspace\fP, int \fIwscount\fP);
+.
+.SH DESCRIPTION
+.rs
+.sp
+This function matches a compiled regular expression against a given subject
+string, using an alternative matching algorithm that scans the subject string
+just once (\fInot\fP Perl-compatible). Note that the main, Perl-compatible,
+matching function is \fBpcre_exec()\fP. The arguments for this function are:
+.sp
+ \fIcode\fP Points to the compiled pattern
+ \fIextra\fP Points to an associated \fBpcre_extra\fP structure,
+ or is NULL
+ \fIsubject\fP Points to the subject string
+ \fIlength\fP Length of the subject string, in bytes
+ \fIstartoffset\fP Offset in bytes in the subject at which to
+ start matching
+ \fIoptions\fP Option bits
+ \fIovector\fP Points to a vector of ints for result offsets
+ \fIovecsize\fP Number of elements in the vector
+ \fIworkspace\fP Points to a vector of ints used as working space
+ \fIwscount\fP Number of elements in the vector
+.sp
+The options are:
+.sp
+ PCRE_ANCHORED Match only at the first position
+ PCRE_BSR_ANYCRLF \eR matches only CR, LF, or CRLF
+ PCRE_BSR_UNICODE \eR matches all Unicode line endings
+ PCRE_NEWLINE_ANY Recognize any Unicode newline sequence
+ PCRE_NEWLINE_ANYCRLF Recognize CR, LF, and CRLF as newline sequences
+ PCRE_NEWLINE_CR Set CR as the newline sequence
+ PCRE_NEWLINE_CRLF Set CRLF as the newline sequence
+ PCRE_NEWLINE_LF Set LF as the newline sequence
+ PCRE_NOTBOL Subject is not the beginning of a line
+ PCRE_NOTEOL Subject is not the end of a line
+ PCRE_NOTEMPTY An empty string is not a valid match
+ PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8
+ validity (only relevant if PCRE_UTF8
+ was set at compile time)
+ PCRE_PARTIAL Return PCRE_ERROR_PARTIAL for a partial match
+ PCRE_DFA_SHORTEST Return only the shortest match
+ PCRE_DFA_RESTART This is a restart after a partial match
+.sp
+There are restrictions on what may appear in a pattern when using this matching
+function. Details are given in the
+.\" HREF
+\fBpcrematching\fP
+.\"
+documentation.
+.P
+A \fBpcre_extra\fP structure contains the following fields:
+.sp
+ \fIflags\fP Bits indicating which fields are set
+ \fIstudy_data\fP Opaque data from \fBpcre_study()\fP
+ \fImatch_limit\fP Limit on internal resource use
+ \fImatch_limit_recursion\fP Limit on internal recursion depth
+ \fIcallout_data\fP Opaque data passed back to callouts
+ \fItables\fP Points to character tables or is NULL
+.sp
+The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,
+PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and
+PCRE_EXTRA_TABLES. For this matching function, the \fImatch_limit\fP and
+\fImatch_limit_recursion\fP fields are not used, and must not be set.
+.P
+There is a complete description of the PCRE native API in the
+.\" HREF
+\fBpcreapi\fP
+.\"
+page and a description of the POSIX API in the
+.\" HREF
+\fBpcreposix\fP
+.\"
+page.
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_exec.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_exec.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_exec.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_exec.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_EXEC 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_exec(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP,"
.ti +5n
.B "const char *\fIsubject\fP," int \fIlength\fP, int \fIstartoffset\fP,
@@ -18,7 +17,8 @@
.rs
.sp
This function matches a compiled regular expression against a given subject
-string, and returns offsets to capturing subexpressions. Its arguments are:
+string, using a matching algorithm that is similar to Perl's. It returns
+offsets to captured substrings. Its arguments are:
.sp
\fIcode\fP Points to the compiled pattern
\fIextra\fP Points to an associated \fBpcre_extra\fP structure,
@@ -34,6 +34,13 @@
The options are:
.sp
PCRE_ANCHORED Match only at the first position
+ PCRE_BSR_ANYCRLF \eR matches only CR, LF, or CRLF
+ PCRE_BSR_UNICODE \eR matches all Unicode line endings
+ PCRE_NEWLINE_ANY Recognize any Unicode newline sequence
+ PCRE_NEWLINE_ANYCRLF Recognize CR, LF, and CRLF as newline sequences
+ PCRE_NEWLINE_CR Set CR as the newline sequence
+ PCRE_NEWLINE_CRLF Set CRLF as the newline sequence
+ PCRE_NEWLINE_LF Set LF as the newline sequence
PCRE_NOTBOL Subject is not the beginning of a line
PCRE_NOTEOL Subject is not the end of a line
PCRE_NOTEMPTY An empty string is not a valid match
@@ -43,18 +50,24 @@
PCRE_PARTIAL Return PCRE_ERROR_PARTIAL for a partial match
.sp
There are restrictions on what may appear in a pattern when partial matching is
-requested.
+requested. For details, see the
+.\" HREF
+\fBpcrepartial\fP
+.\"
+page.
.P
A \fBpcre_extra\fP structure contains the following fields:
.sp
\fIflags\fP Bits indicating which fields are set
\fIstudy_data\fP Opaque data from \fBpcre_study()\fP
- \fImatch_limit\fP Limit on internal recursion
+ \fImatch_limit\fP Limit on internal resource use
+ \fImatch_limit_recursion\fP Limit on internal recursion depth
\fIcallout_data\fP Opaque data passed back to callouts
\fItables\fP Points to character tables or is NULL
.sp
The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,
-PCRE_EXTRA_CALLOUT_DATA, and PCRE_EXTRA_TABLES.
+PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and
+PCRE_EXTRA_TABLES.
.P
There is a complete description of the PCRE native API in the
.\" HREF
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_free_substring.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_free_substring.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_free_substring.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_free_substring.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_FREE_SUBSTRING 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B void pcre_free_substring(const char *\fIstringptr\fP);
.
.SH DESCRIPTION
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_free_substring_list.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_free_substring_list.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_free_substring_list.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_free_substring_list.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_FREE_SUBSTRING_LIST 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B void pcre_free_substring_list(const char **\fIstringptr\fP);
.
.SH DESCRIPTION
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_fullinfo.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_fullinfo.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_fullinfo.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_fullinfo.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_FULLINFO 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_fullinfo(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP,"
.ti +5n
.B int \fIwhat\fP, void *\fIwhere\fP);
@@ -31,13 +30,14 @@
-1 for start of string
or after newline, or
-2 otherwise
- PCRE_INFO_FIRSTTABLE Table of first bytes
- (after studying)
+ PCRE_INFO_FIRSTTABLE Table of first bytes (after studying)
+ PCRE_INFO_JCHANGED Return 1 if (?J) was used
PCRE_INFO_LASTLITERAL Literal last byte required
PCRE_INFO_NAMECOUNT Number of named subpatterns
PCRE_INFO_NAMEENTRYSIZE Size of name table entry
PCRE_INFO_NAMETABLE Pointer to name table
- PCRE_INFO_OPTIONS Options used for compilation
+ PCRE_INFO_OKPARTIAL Return 1 if partial matching can be tried
+ PCRE_INFO_OPTIONS Option bits used for compilation
PCRE_INFO_SIZE Size of compiled pattern
PCRE_INFO_STUDYSIZE Size of study data
.sp
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_get_named_substring.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_get_named_substring.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_get_named_substring.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_get_named_substring.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_GET_NAMED_SUBSTRING 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_get_named_substring(const pcre *\fIcode\fP,
.ti +5n
.B const char *\fIsubject\fP, int *\fIovector\fP,
@@ -30,9 +29,10 @@
\fIstringptr\fP Where to put the string pointer
.sp
The memory in which the substring is placed is obtained by calling
-\fBpcre_malloc()\fP. The yield of the function is the length of the extracted
-substring, PCRE_ERROR_NOMEMORY if sufficient memory could not be obtained, or
-PCRE_ERROR_NOSUBSTRING if the string name is invalid.
+\fBpcre_malloc()\fP. The convenience function \fBpcre_free_substring()\fP can
+be used to free it when it is no longer needed. The yield of the function is
+the length of the extracted substring, PCRE_ERROR_NOMEMORY if sufficient memory
+could not be obtained, or PCRE_ERROR_NOSUBSTRING if the string name is invalid.
.P
There is a complete description of the PCRE native API in the
.\" HREF
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_get_stringnumber.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_get_stringnumber.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_get_stringnumber.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_get_stringnumber.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_GET_STRINGNUMBER 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_get_stringnumber(const pcre *\fIcode\fP,
.ti +5n
.B const char *\fIname\fP);
@@ -22,7 +21,10 @@
\fIname\fP Name whose number is required
.sp
The yield of the function is the number of the parenthesis if the name is
-found, or PCRE_ERROR_NOSUBSTRING otherwise.
+found, or PCRE_ERROR_NOSUBSTRING otherwise. When duplicate names are allowed
+(PCRE_DUPNAMES is set), it is not defined which of the numbers is returned by
+\fBpcre_get_stringnumber()\fP. You can obtain the complete list by calling
+\fBpcre_get_stringtable_entries()\fP.
.P
There is a complete description of the PCRE native API in the
.\" HREF
Added: httpd/httpd/vendor/pcre/current/doc/pcre_get_stringtable_entries.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_get_stringtable_entries.3?rev=598339&view=auto
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_get_stringtable_entries.3 (added)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_get_stringtable_entries.3 Mon Nov 26 08:49:53 2007
@@ -0,0 +1,40 @@
+.TH PCRE_GET_STRINGTABLE_ENTRIES 3
+.SH NAME
+PCRE - Perl-compatible regular expressions
+.SH SYNOPSIS
+.rs
+.sp
+.B #include <pcre.h>
+.PP
+.SM
+.B int pcre_get_stringtable_entries(const pcre *\fIcode\fP,
+.ti +5n
+.B const char *\fIname\fP, char **\fIfirst\fP, char **\fIlast\fP);
+.
+.SH DESCRIPTION
+.rs
+.sp
+This convenience function finds, for a compiled pattern, the first and last
+entries for a given name in the table that translates capturing parenthesis
+names into numbers. When names are required to be unique (PCRE_DUPNAMES is
+\fInot\fP set), it is usually easier to use \fBpcre_get_stringnumber()\fP
+instead.
+.sp
+ \fIcode\fP Compiled regular expression
+ \fIname\fP Name whose entries required
+ \fIfirst\fP Where to return a pointer to the first entry
+ \fIlast\fP Where to return a pointer to the last entry
+.sp
+The yield of the function is the length of each entry, or
+PCRE_ERROR_NOSUBSTRING if none are found.
+.P
+There is a complete description of the PCRE native API, including the format of
+the table entries, in the
+.\" HREF
+\fBpcreapi\fP
+.\"
+page, and a description of the POSIX API in the
+.\" HREF
+\fBpcreposix\fP
+.\"
+page.
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_get_substring.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_get_substring.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_get_substring.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_get_substring.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_GET_SUBSTRING 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_get_substring(const char *\fIsubject\fP, int *\fIovector\fP,
.ti +5n
.B int \fIstringcount\fP, int \fIstringnumber\fP,
@@ -27,9 +26,10 @@
\fIstringptr\fP Where to put the string pointer
.sp
The memory in which the substring is placed is obtained by calling
-\fBpcre_malloc()\fP. The yield of the function is the length of the substring,
-PCRE_ERROR_NOMEMORY if sufficient memory could not be obtained, or
-PCRE_ERROR_NOSUBSTRING if the string number is invalid.
+\fBpcre_malloc()\fP. The convenience function \fBpcre_free_substring()\fP can
+be used to free it when it is no longer needed. The yield of the function is
+the length of the substring, PCRE_ERROR_NOMEMORY if sufficient memory could not
+be obtained, or PCRE_ERROR_NOSUBSTRING if the string number is invalid.
.P
There is a complete description of the PCRE native API in the
.\" HREF
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_get_substring_list.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_get_substring_list.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_get_substring_list.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_get_substring_list.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_GET_SUBSTRING_LIST 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_get_substring_list(const char *\fIsubject\fP,
.ti +5n
.B int *\fIovector\fP, int \fIstringcount\fP, "const char ***\fIlistptr\fP);"
@@ -24,10 +23,12 @@
\fIlistptr\fP Where to put a pointer to the list
.sp
The memory in which the substrings and the list are placed is obtained by
-calling \fBpcre_malloc()\fP. A pointer to a list of pointers is put in
-the variable whose address is in \fIlistptr\fP. The list is terminated by a
-NULL pointer. The yield of the function is zero on success or
-PCRE_ERROR_NOMEMORY if sufficient memory could not be obtained.
+calling \fBpcre_malloc()\fP. The convenience function
+\fBpcre_free_substring_list()\fP can be used to free it when it is no longer
+needed. A pointer to a list of pointers is put in the variable whose address is
+in \fIlistptr\fP. The list is terminated by a NULL pointer. The yield of the
+function is zero on success or PCRE_ERROR_NOMEMORY if sufficient memory could
+not be obtained.
.P
There is a complete description of the PCRE native API in the
.\" HREF
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_info.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_info.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_info.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_info.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_INFO 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B int pcre_info(const pcre *\fIcode\fP, int *\fIoptptr\fP, int
.B *\fIfirstcharptr\fP);
.
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_maketables.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_maketables.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_maketables.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_maketables.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_MAKETABLES 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B const unsigned char *pcre_maketables(void);
.
.SH DESCRIPTION
Added: httpd/httpd/vendor/pcre/current/doc/pcre_refcount.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_refcount.3?rev=598339&view=auto
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_refcount.3 (added)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_refcount.3 Mon Nov 26 08:49:53 2007
@@ -0,0 +1,32 @@
+.TH PCRE_REFCOUNT 3
+.SH NAME
+PCRE - Perl-compatible regular expressions
+.SH SYNOPSIS
+.rs
+.sp
+.B #include <pcre.h>
+.PP
+.SM
+.B int pcre_refcount(pcre *\fIcode\fP, int \fIadjust\fP);
+.
+.SH DESCRIPTION
+.rs
+.sp
+This function is used to maintain a reference count inside a data block that
+contains a compiled pattern. Its arguments are:
+.sp
+ \fIcode\fP Compiled regular expression
+ \fIadjust\fP Adjustment to reference value
+.sp
+The yield of the function is the adjusted reference value, which is constrained
+to lie between 0 and 65535.
+.P
+There is a complete description of the PCRE native API in the
+.\" HREF
+\fBpcreapi\fP
+.\"
+page and a description of the POSIX API in the
+.\" HREF
+\fBpcreposix\fP
+.\"
+page.
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_study.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_study.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_study.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_study.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_STUDY 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B pcre_extra *pcre_study(const pcre *\fIcode\fP, int \fIoptions\fP,
.ti +5n
.B const char **\fIerrptr\fP);
Modified: httpd/httpd/vendor/pcre/current/doc/pcre_version.3
URL: http://svn.apache.org/viewvc/httpd/httpd/vendor/pcre/current/doc/pcre_version.3?rev=598339&r1=598338&r2=598339&view=diff
==============================================================================
--- httpd/httpd/vendor/pcre/current/doc/pcre_version.3 (original)
+++ httpd/httpd/vendor/pcre/current/doc/pcre_version.3 Mon Nov 26 08:49:53 2007
@@ -1,4 +1,4 @@
-.TH PCRE 3
+.TH PCRE_VERSION 3
.SH NAME
PCRE - Perl-compatible regular expressions
.SH SYNOPSIS
@@ -7,7 +7,6 @@
.B #include <pcre.h>
.PP
.SM
-.br
.B char *pcre_version(void);
.
.SH DESCRIPTION