embedaddon/pcre/doc/pcre.3 - diff

Return to pcre.3 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / pcre / doc

Diff for /embedaddon/pcre/doc/pcre.3 between versions 1.1.1.1 and 1.1.1.2

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

version 1.1.1.1, 2012/02/21 23:05:52	version 1.1.1.2, 2012/02/21 23:50:25
Line 11 appeared in Perl are also available using the Python s	Line 11 appeared in Perl are also available using the Python s
support for one or two .NET and Oniguruma syntax items, and there is an option	support for one or two .NET and Oniguruma syntax items, and there is an option
for requesting some minor changes that give better JavaScript compatibility.	for requesting some minor changes that give better JavaScript compatibility.
.P	.P
	Starting with release 8.30, it is possible to compile two separate PCRE
	libraries: the original, which supports 8-bit character strings (including
	UTF-8 strings), and a second library that supports 16-bit character strings
	(including UTF-16 strings). The build process allows either one or both to be
	built. The majority of the work to make this possible was done by Zoltan
	Herczeg.
	.P
	The two libraries contain identical sets of functions, except that the names in
	the 16-bit library start with \fBpcre16_\fP instead of \fBpcre_\fP. To avoid
	over-complication and reduce the documentation maintenance load, most of the
	documentation describes the 8-bit library, with the differences for the 16-bit
	library described separately in the
	.\" HREF
	\fBpcre16\fP
	.\"
	page. References to functions or structures of the form \fIpcre[16]_xxx\fP
	should be read as meaning "\fIpcre_xxx\fP when using the 8-bit library and
	\fIpcre16_xxx\fP when using the 16-bit library".
	.P
The current implementation of PCRE corresponds approximately with Perl 5.12,	The current implementation of PCRE corresponds approximately with Perl 5.12,
including support for UTF-8 encoded strings and Unicode general category	including support for UTF-8/16 encoded strings and Unicode general category
properties. However, UTF-8 and Unicode support has to be explicitly enabled; it	properties. However, UTF-8/16 and Unicode support has to be explicitly enabled;
is not the default. The Unicode tables correspond to Unicode release 6.0.0.	it is not the default. The Unicode tables correspond to Unicode release 6.0.0.
.P	.P
In addition to the Perl-compatible matching function, PCRE contains an	In addition to the Perl-compatible matching function, PCRE contains an
alternative function that matches the same compiled patterns in a different	alternative function that matches the same compiled patterns in a different
Line 27 page.	Line 46 page.
.P	.P
PCRE is written in C and released as a C library. A number of people have	PCRE is written in C and released as a C library. A number of people have
written wrappers and interfaces of various kinds. In particular, Google Inc.	written wrappers and interfaces of various kinds. In particular, Google Inc.
have provided a comprehensive C++ wrapper. This is now included as part of the	have provided a comprehensive C++ wrapper for the 8-bit library. This is now
PCRE distribution. The	included as part of the PCRE distribution. The
.\" HREF	.\" HREF
\fBpcrecpp\fP	\fBpcrecpp\fP
.\"	.\"
Line 68 page. Documentation about building PCRE for various op	Line 87 page. Documentation about building PCRE for various op
found in the \fBREADME\fP and \fBNON-UNIX-USE\fP files in the source	found in the \fBREADME\fP and \fBNON-UNIX-USE\fP files in the source
distribution.	distribution.
.P	.P
The library contains a number of undocumented internal functions and data	The libraries contains a number of undocumented internal functions and data
tables that are used by more than one of the exported external functions, but	tables that are used by more than one of the exported external functions, but
which are not intended for use by external callers. Their names all begin with	which are not intended for use by external callers. Their names all begin with
"_pcre_", which hopefully will not provoke any name clashes. In some	"_pcre_" or "_pcre16_", which hopefully will not provoke any name clashes. In
environments, it is possible to control which external symbols are exported	some environments, it is possible to control which external symbols are
when a shared library is built, and in these cases the undocumented symbols are	exported when a shared library is built, and in these cases the undocumented
not exported.	symbols are not exported.
.	.
.	.
.SH "USER DOCUMENTATION"	.SH "USER DOCUMENTATION"
Line 87 all the sections, except the \fBpcredemo\fP section, a	Line 106 all the sections, except the \fBpcredemo\fP section, a
of searching. The sections are as follows:	of searching. The sections are as follows:
.sp	.sp
pcre this document	pcre this document
	pcre16 details of the 16-bit library
pcre-config show PCRE installation configuration information	pcre-config show PCRE installation configuration information
pcreapi details of PCRE's native C API	pcreapi details of PCRE's native C API
pcrebuild options for building PCRE	pcrebuild options for building PCRE
pcrecallout details of the callout feature	pcrecallout details of the callout feature
pcrecompat discussion of Perl compatibility	pcrecompat discussion of Perl compatibility
pcrecpp details of the C++ wrapper	pcrecpp details of the C++ wrapper for the 8-bit library
pcredemo a demonstration C program that uses PCRE	pcredemo a demonstration C program that uses PCRE
pcregrep description of the \fBpcregrep\fP command	pcregrep description of the \fBpcregrep\fP command (8-bit only)
pcrejit discussion of the just-in-time optimization support	pcrejit discussion of the just-in-time optimization support
pcrelimits details of size and other limits	pcrelimits details of size and other limits
pcrematching discussion of the two matching algorithms	pcrematching discussion of the two matching algorithms
Line 103 of searching. The sections are as follows:	Line 123 of searching. The sections are as follows:
pcrepattern syntax and semantics of supported	pcrepattern syntax and semantics of supported
regular expressions	regular expressions
pcreperform discussion of performance issues	pcreperform discussion of performance issues
pcreposix the POSIX-compatible C API	pcreposix the POSIX-compatible C API for the 8-bit library
pcreprecompile details of saving and re-using precompiled patterns	pcreprecompile details of saving and re-using precompiled patterns
pcresample discussion of the pcredemo program	pcresample discussion of the pcredemo program
pcrestack discussion of stack usage	pcrestack discussion of stack usage
pcresyntax quick syntax reference	pcresyntax quick syntax reference
pcretest description of the \fBpcretest\fP testing command	pcretest description of the \fBpcretest\fP testing command
pcreunicode discussion of Unicode and UTF-8 support	pcreunicode discussion of Unicode and UTF-8/16 support
.sp	.sp
In addition, in the "man" and HTML formats, there is a short page for each	In addition, in the "man" and HTML formats, there is a short page for each
C library function, listing its arguments and results.	8-bit C library function, listing its arguments and results.
.	.
.	.
.SH AUTHOR	.SH AUTHOR
Line 133 two digits 10, at the domain cam.ac.uk.	Line 153 two digits 10, at the domain cam.ac.uk.
.rs	.rs
.sp	.sp
.nf	.nf
Last updated: 24 August 2011	Last updated: 10 January 2012
Copyright (c) 1997-2011 University of Cambridge.	Copyright (c) 1997-2012 University of Cambridge.
.fi	.fi

Removed from v.1.1.1.1
changed lines
	Added in v.1.1.1.2