| 30 |
The PCRE APIs |
The PCRE APIs |
| 31 |
------------- |
------------- |
| 32 |
|
|
| 33 |
PCRE is written in C, and it has its own API. The distribution now includes a |
PCRE is written in C, and it has its own API. The distribution also includes a |
| 34 |
set of C++ wrapper functions, courtesy of Google Inc. (see the pcrecpp man page |
set of C++ wrapper functions (see the pcrecpp man page for details), courtesy |
| 35 |
for details). |
of Google Inc. |
| 36 |
|
|
| 37 |
Also included in the distribution are a set of C wrapper functions that are |
In addition, there is a set of C wrapper functions that are based on the POSIX |
| 38 |
based on the POSIX API. These end up in the library called libpcreposix. Note |
regular expression API (see the pcreposix man page). These end up in the |
| 39 |
that this just provides a POSIX calling interface to PCRE; the regular |
library called libpcreposix. Note that this just provides a POSIX calling |
| 40 |
expressions themselves still follow Perl syntax and semantics. The POSIX API is |
interface to PCRE; the regular expressions themselves still follow Perl syntax |
| 41 |
restricted, and does not give full access to all of PCRE's facilities. |
and semantics. The POSIX API is restricted, and does not give full access to |
| 42 |
|
all of PCRE's facilities. |
| 43 |
|
|
| 44 |
The header file for the POSIX-style functions is called pcreposix.h. The |
The header file for the POSIX-style functions is called pcreposix.h. The |
| 45 |
official POSIX name is regex.h, but I did not want to risk possible problems |
official POSIX name is regex.h, but I did not want to risk possible problems |
| 92 |
|
|
| 93 |
There is a README file giving brief descriptions of what they are. Some are |
There is a README file giving brief descriptions of what they are. Some are |
| 94 |
complete in themselves; others are pointers to URLs containing relevant files. |
complete in themselves; others are pointers to URLs containing relevant files. |
| 95 |
Some of this material is likely to be well out-of-date. In particular, several |
Some of this material is likely to be well out-of-date. Several of the earlier |
| 96 |
of the contributions provide support for compiling PCRE on various flavours of |
contributions provided support for compiling PCRE on various flavours of |
| 97 |
Windows (I myself do not use Windows), but nowadays there is more Windows |
Windows (I myself do not use Windows). Nowadays there is more Windows support |
| 98 |
support in the standard distribution. |
in the standard distribution, so these contibutions have been archived. |
| 99 |
|
|
| 100 |
|
|
| 101 |
Building PCRE on non-Unix systems |
Building PCRE on non-Unix systems |
| 103 |
|
|
| 104 |
For a non-Unix system, please read the comments in the file NON-UNIX-USE, |
For a non-Unix system, please read the comments in the file NON-UNIX-USE, |
| 105 |
though if your system supports the use of "configure" and "make" you may be |
though if your system supports the use of "configure" and "make" you may be |
| 106 |
able to build PCRE in the same way as for Unix-like systems. |
able to build PCRE in the same way as for Unix-like systems. PCRE can also be |
| 107 |
|
configured in many platform environments using the GUI facility of CMake's |
| 108 |
|
CMakeSetup. It creates Makefiles, solution files, etc. |
| 109 |
|
|
| 110 |
PCRE has been compiled on many different operating systems. It should be |
PCRE has been compiled on many different operating systems. It should be |
| 111 |
straightforward to build PCRE on any system that has a Standard C compiler and |
straightforward to build PCRE on any system that has a Standard C compiler and |
| 118 |
If you are using HP's ANSI C++ compiler (aCC), please see the special note |
If you are using HP's ANSI C++ compiler (aCC), please see the special note |
| 119 |
in the section entitled "Using HP's ANSI C++ compiler (aCC)" below. |
in the section entitled "Using HP's ANSI C++ compiler (aCC)" below. |
| 120 |
|
|
| 121 |
|
The following instructions assume the use of the widely used "configure, make, |
| 122 |
|
make install" process. There is also some experimental support for "cmake" in |
| 123 |
|
the PCRE distribution, but it is incomplete and not documented. However, if you |
| 124 |
|
are a "cmake" user, you might want to try it. |
| 125 |
|
|
| 126 |
To build PCRE on a Unix-like system, first run the "configure" command from the |
To build PCRE on a Unix-like system, first run the "configure" command from the |
| 127 |
PCRE distribution directory, with your current directory set to the directory |
PCRE distribution directory, with your current directory set to the directory |
| 128 |
where you want the files to be created. This command is a standard GNU |
where you want the files to be created. This command is a standard GNU |
| 155 |
|
|
| 156 |
. If you want to suppress the building of the C++ wrapper library, you can add |
. If you want to suppress the building of the C++ wrapper library, you can add |
| 157 |
--disable-cpp to the "configure" command. Otherwise, when "configure" is run, |
--disable-cpp to the "configure" command. Otherwise, when "configure" is run, |
| 158 |
will try to find a C++ compiler and C++ header files, and if it succeeds, it |
it will try to find a C++ compiler and C++ header files, and if it succeeds, |
| 159 |
will try to build the C++ wrapper. |
it will try to build the C++ wrapper. |
| 160 |
|
|
| 161 |
. If you want to make use of the support for UTF-8 character strings in PCRE, |
. If you want to make use of the support for UTF-8 character strings in PCRE, |
| 162 |
you must add --enable-utf8 to the "configure" command. Without it, the code |
you must add --enable-utf8 to the "configure" command. Without it, the code |
| 171 |
supported. |
supported. |
| 172 |
|
|
| 173 |
. You can build PCRE to recognize either CR or LF or the sequence CRLF or any |
. You can build PCRE to recognize either CR or LF or the sequence CRLF or any |
| 174 |
of the Unicode newline sequences as indicating the end of a line. Whatever |
of the preceding, or any of the Unicode newline sequences as indicating the |
| 175 |
you specify at build time is the default; the caller of PCRE can change the |
end of a line. Whatever you specify at build time is the default; the caller |
| 176 |
selection at run time. The default newline indicator is a single LF character |
of PCRE can change the selection at run time. The default newline indicator |
| 177 |
(the Unix standard). You can specify the default newline indicator by adding |
is a single LF character (the Unix standard). You can specify the default |
| 178 |
--newline-is-cr or --newline-is-lf or --newline-is-crlf or --newline-is-any |
newline indicator by adding --enable-newline-is-cr or --enable-newline-is-lf |
| 179 |
to the "configure" command, respectively. |
or --enable-newline-is-crlf or --enable-newline-is-anycrlf or |
| 180 |
|
--enable-newline-is-any to the "configure" command, respectively. |
| 181 |
If you specify --newline-is-cr or --newline-is-crlf, some of the standard |
|
| 182 |
tests will fail, because the lines in the test files end with LF. Even if |
If you specify --enable-newline-is-cr or --enable-newline-is-crlf, some of |
| 183 |
the files are edited to change the line endings, there are likely to be some |
the standard tests will fail, because the lines in the test files end with |
| 184 |
failures. With --newline-is-any, many tests should succeed, but there may be |
LF. Even if the files are edited to change the line endings, there are likely |
| 185 |
some failures. |
to be some failures. With --enable-newline-is-anycrlf or |
| 186 |
|
--enable-newline-is-any, many tests should succeed, but there may be some |
| 187 |
|
failures. |
| 188 |
|
|
| 189 |
|
. By default, the sequence \R in a pattern matches any Unicode line ending |
| 190 |
|
sequence. This is independent of the option specifying what PCRE considers to |
| 191 |
|
be the end of a line (see above). However, the caller of PCRE can restrict \R |
| 192 |
|
to match only CR, LF, or CRLF. You can make this the default by adding |
| 193 |
|
--enable-bsr-anycrlf to the "configure" command (bsr = "backslash R"). |
| 194 |
|
|
| 195 |
. When called via the POSIX interface, PCRE uses malloc() to get additional |
. When called via the POSIX interface, PCRE uses malloc() to get additional |
| 196 |
storage for processing capturing parentheses if there are more than 10 of |
storage for processing capturing parentheses if there are more than 10 of |
| 197 |
them. You can increase this threshold by setting, for example, |
them in a pattern. You can increase this threshold by setting, for example, |
| 198 |
|
|
| 199 |
--with-posix-malloc-threshold=20 |
--with-posix-malloc-threshold=20 |
| 200 |
|
|
| 223 |
. The default maximum compiled pattern size is around 64K. You can increase |
. The default maximum compiled pattern size is around 64K. You can increase |
| 224 |
this by adding --with-link-size=3 to the "configure" command. You can |
this by adding --with-link-size=3 to the "configure" command. You can |
| 225 |
increase it even more by setting --with-link-size=4, but this is unlikely |
increase it even more by setting --with-link-size=4, but this is unlikely |
| 226 |
ever to be necessary. |
ever to be necessary. Increasing the internal link size will reduce |
| 227 |
|
performance. |
| 228 |
|
|
| 229 |
. You can build PCRE so that its internal match() function that is called from |
. You can build PCRE so that its internal match() function that is called from |
| 230 |
pcre_exec() does not call itself recursively. Instead, it uses memory blocks |
pcre_exec() does not call itself recursively. Instead, it uses memory blocks |
| 240 |
use deeply nested recursion. There is a discussion about stack sizes in the |
use deeply nested recursion. There is a discussion about stack sizes in the |
| 241 |
pcrestack man page. |
pcrestack man page. |
| 242 |
|
|
| 243 |
|
. For speed, PCRE uses four tables for manipulating and identifying characters |
| 244 |
|
whose code point values are less than 256. By default, it uses a set of |
| 245 |
|
tables for ASCII encoding that is part of the distribution. If you specify |
| 246 |
|
|
| 247 |
|
--enable-rebuild-chartables |
| 248 |
|
|
| 249 |
|
a program called dftables is compiled and run in the default C locale when |
| 250 |
|
you obey "make". It builds a source file called pcre_chartables.c. If you do |
| 251 |
|
not specify this option, pcre_chartables.c is created as a copy of |
| 252 |
|
pcre_chartables.c.dist. See "Character tables" below for further information. |
| 253 |
|
|
| 254 |
|
. It is possible to compile PCRE for use on systems that use EBCDIC as their |
| 255 |
|
default character code (as opposed to ASCII) by specifying |
| 256 |
|
|
| 257 |
|
--enable-ebcdic |
| 258 |
|
|
| 259 |
|
This automatically implies --enable-rebuild-chartables (see above). |
| 260 |
|
|
| 261 |
|
. It is possible to compile pcregrep to use libz and/or libbz2 to read .gz |
| 262 |
|
and .bz2 files (respectively) by specifying one or both of |
| 263 |
|
|
| 264 |
|
--enable-pcregrep-libz |
| 265 |
|
--enable-pcregrep-libbz2 |
| 266 |
|
|
| 267 |
The "configure" script builds the following files for the basic C library: |
The "configure" script builds the following files for the basic C library: |
| 268 |
|
|
| 269 |
. Makefile is the makefile that builds the library |
. Makefile is the makefile that builds the library |
| 412 |
------------------------------------ |
------------------------------------ |
| 413 |
|
|
| 414 |
You can specify CC and CFLAGS in the normal way to the "configure" command, in |
You can specify CC and CFLAGS in the normal way to the "configure" command, in |
| 415 |
order to cross-compile PCRE for some other host. However, during the building |
order to cross-compile PCRE for some other host. However, you should NOT |
| 416 |
process, the dftables.c source file is compiled *and run* on the local host, in |
specify --enable-rebuild-chartables, because if you do, the dftables.c source |
| 417 |
order to generate the default character tables (the chartables.c file). It |
file is compiled and run on the local host, in order to generate the inbuilt |
| 418 |
therefore needs to be compiled with the local compiler, not the cross compiler. |
character tables (the pcre_chartables.c file). This will probably not work, |
| 419 |
You can do this by specifying CC_FOR_BUILD (and if necessary CFLAGS_FOR_BUILD; |
because dftables.c needs to be compiled with the local compiler, not the cross |
| 420 |
there are also CXX_FOR_BUILD and CXXFLAGS_FOR_BUILD for the C++ wrapper) |
compiler. |
| 421 |
when calling the "configure" command. If they are not specified, they default |
|
| 422 |
to the values of CC and CFLAGS. |
When --enable-rebuild-chartables is not specified, pcre_chartables.c is created |
| 423 |
|
by making a copy of pcre_chartables.c.dist, which is a default set of tables |
| 424 |
|
that assumes ASCII code. Cross-compiling with the default tables should not be |
| 425 |
|
a problem. |
| 426 |
|
|
| 427 |
|
If you need to modify the character tables when cross-compiling, you should |
| 428 |
|
move pcre_chartables.c.dist out of the way, then compile dftables.c by hand and |
| 429 |
|
run it on the local host to make a new version of pcre_chartables.c.dist. |
| 430 |
|
Then when you cross-compile PCRE this new version of the tables will be used. |
| 431 |
|
|
| 432 |
|
|
| 433 |
Using HP's ANSI C++ compiler (aCC) |
Using HP's ANSI C++ compiler (aCC) |
| 450 |
------------------- |
------------------- |
| 451 |
|
|
| 452 |
The command "make dist" creates three PCRE tarballs, in tar.gz, tar.bz2, and |
The command "make dist" creates three PCRE tarballs, in tar.gz, tar.bz2, and |
| 453 |
zip formats. However, if you have modified any of the man page sources in the |
zip formats. The command "make distcheck" does the same, but then does a trial |
| 454 |
doc directory, you should first run the PrepareRelease script. This re-creates |
build of the new distribution to ensure that it works. |
| 455 |
the .txt and HTML forms of the documentation from the man pages. |
|
| 456 |
|
If you have modified any of the man page sources in the doc directory, you |
| 457 |
|
should first run the PrepareRelease script before making a distribution. This |
| 458 |
|
script creates the .txt and HTML forms of the documentation from the man pages. |
| 459 |
|
|
| 460 |
|
|
| 461 |
Testing PCRE |
Testing PCRE |
| 513 |
in the comparison output, it means that locale is not available on your system, |
in the comparison output, it means that locale is not available on your system, |
| 514 |
despite being listed by "locale". This does not mean that PCRE is broken. |
despite being listed by "locale". This does not mean that PCRE is broken. |
| 515 |
|
|
| 516 |
|
[If you are trying to run this test on Windows, you may be able to get it to |
| 517 |
|
work by changing "fr_FR" to "french" everywhere it occurs. Alternatively, use |
| 518 |
|
RunTest.bat. The version of RunTest.bat included with PCRE 7.4 and above uses |
| 519 |
|
Windows versions of test 2. More info on using RunTest.bat is included in the |
| 520 |
|
document entitled NON-UNIX-USE.] |
| 521 |
|
|
| 522 |
The fourth test checks the UTF-8 support. It is not run automatically unless |
The fourth test checks the UTF-8 support. It is not run automatically unless |
| 523 |
PCRE is built with UTF-8 support. To do this you must set --enable-utf8 when |
PCRE is built with UTF-8 support. To do this you must set --enable-utf8 when |
| 524 |
running "configure". This file can be also fed directly to the perltest script, |
running "configure". This file can be also fed directly to the perltest script, |
| 548 |
of tables in the current locale. If the final argument for pcre_compile() is |
of tables in the current locale. If the final argument for pcre_compile() is |
| 549 |
passed as NULL, a set of default tables that is built into the binary is used. |
passed as NULL, a set of default tables that is built into the binary is used. |
| 550 |
|
|
| 551 |
The source file called chartables.c contains the default set of tables. This is |
The source file called pcre_chartables.c contains the default set of tables. By |
| 552 |
not supplied in the distribution, but is built by the program dftables |
default, this is created as a copy of pcre_chartables.c.dist, which contains |
| 553 |
(compiled from dftables.c), which uses the ANSI C character handling functions |
tables for ASCII coding. However, if --enable-rebuild-chartables is specified |
| 554 |
such as isalnum(), isalpha(), isupper(), islower(), etc. to build the table |
for ./configure, a different version of pcre_chartables.c is built by the |
| 555 |
sources. This means that the default C locale which is set for your system will |
program dftables (compiled from dftables.c), which uses the ANSI C character |
| 556 |
control the contents of these default tables. You can change the default tables |
handling functions such as isalnum(), isalpha(), isupper(), islower(), etc. to |
| 557 |
by editing chartables.c and then re-building PCRE. If you do this, you should |
build the table sources. This means that the default C locale which is set for |
| 558 |
take care to ensure that the file does not get automaticaly re-generated. |
your system will control the contents of these default tables. You can change |
| 559 |
|
the default tables by editing pcre_chartables.c and then re-building PCRE. If |
| 560 |
|
you do this, you should take care to ensure that the file does not get |
| 561 |
|
automatically re-generated. The best way to do this is to move |
| 562 |
|
pcre_chartables.c.dist out of the way and replace it with your customized |
| 563 |
|
tables. |
| 564 |
|
|
| 565 |
|
When the dftables program is run as a result of --enable-rebuild-chartables, |
| 566 |
|
it uses the default C locale that is set on your system. It does not pay |
| 567 |
|
attention to the LC_xxx environment variables. In other words, it uses the |
| 568 |
|
system's default locale rather than whatever the compiling user happens to have |
| 569 |
|
set. If you really do want to build a source set of character tables in a |
| 570 |
|
locale that is specified by the LC_xxx variables, you can run the dftables |
| 571 |
|
program by hand with the -L option. For example: |
| 572 |
|
|
| 573 |
|
./dftables -L pcre_chartables.c.special |
| 574 |
|
|
| 575 |
The first two 256-byte tables provide lower casing and case flipping functions, |
The first two 256-byte tables provide lower casing and case flipping functions, |
| 576 |
respectively. The next table consists of three 32-byte bit maps which identify |
respectively. The next table consists of three 32-byte bit maps which identify |
| 599 |
|
|
| 600 |
(A) Source files of the PCRE library functions and their headers: |
(A) Source files of the PCRE library functions and their headers: |
| 601 |
|
|
| 602 |
dftables.c auxiliary program for building chartables.c |
dftables.c auxiliary program for building pcre_chartables.c |
| 603 |
|
when --enable-rebuild-chartables is specified |
| 604 |
|
|
| 605 |
pcreposix.c ) |
pcre_chartables.c.dist a default set of character tables that assume ASCII |
| 606 |
pcre_compile.c ) |
coding; used, unless --enable-rebuild-chartables is |
| 607 |
pcre_config.c ) |
specified, by copying to pcre_chartables.c |
| 608 |
pcre_dfa_exec.c ) |
|
| 609 |
pcre_exec.c ) |
pcreposix.c ) |
| 610 |
pcre_fullinfo.c ) |
pcre_compile.c ) |
| 611 |
pcre_get.c ) sources for the functions in the library, |
pcre_config.c ) |
| 612 |
pcre_globals.c ) and some internal functions that they use |
pcre_dfa_exec.c ) |
| 613 |
pcre_info.c ) |
pcre_exec.c ) |
| 614 |
pcre_maketables.c ) |
pcre_fullinfo.c ) |
| 615 |
pcre_newline.c ) |
pcre_get.c ) sources for the functions in the library, |
| 616 |
pcre_ord2utf8.c ) |
pcre_globals.c ) and some internal functions that they use |
| 617 |
pcre_refcount.c ) |
pcre_info.c ) |
| 618 |
pcre_study.c ) |
pcre_maketables.c ) |
| 619 |
pcre_tables.c ) |
pcre_newline.c ) |
| 620 |
pcre_try_flipped.c ) |
pcre_ord2utf8.c ) |
| 621 |
pcre_ucp_searchfuncs.c ) |
pcre_refcount.c ) |
| 622 |
pcre_valid_utf8.c ) |
pcre_study.c ) |
| 623 |
pcre_version.c ) |
pcre_tables.c ) |
| 624 |
pcre_xclass.c ) |
pcre_try_flipped.c ) |
| 625 |
pcre_printint.src ) debugging function that is #included in pcretest, |
pcre_ucp_searchfuncs.c ) |
| 626 |
) and can also be #included in pcre_compile() |
pcre_valid_utf8.c ) |
| 627 |
pcre.h.in template for pcre.h when built by "configure" |
pcre_version.c ) |
| 628 |
pcreposix.h header for the external POSIX wrapper API |
pcre_xclass.c ) |
| 629 |
pcre_internal.h header for internal use |
pcre_printint.src ) debugging function that is #included in pcretest, |
| 630 |
ucp.h ) headers concerned with |
) and can also be #included in pcre_compile() |
| 631 |
ucpinternal.h ) Unicode property handling |
pcre.h.in template for pcre.h when built by "configure" |
| 632 |
ucptable.h ) (this one is the data table) |
pcreposix.h header for the external POSIX wrapper API |
| 633 |
|
pcre_internal.h header for internal use |
| 634 |
config.h.in template for config.h, which is built by "configure" |
ucp.h ) headers concerned with |
| 635 |
|
ucpinternal.h ) Unicode property handling |
| 636 |
pcrecpp.h public header file for the C++ wrapper |
ucptable.h ) (this one is the data table) |
| 637 |
pcrecpparg.h.in template for another C++ header file |
|
| 638 |
pcre_scanner.h public header file for C++ scanner functions |
config.h.in template for config.h, which is built by "configure" |
| 639 |
pcrecpp.cc ) |
|
| 640 |
pcre_scanner.cc ) source for the C++ wrapper library |
pcrecpp.h public header file for the C++ wrapper |
| 641 |
|
pcrecpparg.h.in template for another C++ header file |
| 642 |
pcre_stringpiece.h.in template for pcre_stringpiece.h, the header for the |
pcre_scanner.h public header file for C++ scanner functions |
| 643 |
C++ stringpiece functions |
pcrecpp.cc ) |
| 644 |
pcre_stringpiece.cc source for the C++ stringpiece functions |
pcre_scanner.cc ) source for the C++ wrapper library |
| 645 |
|
|
| 646 |
|
pcre_stringpiece.h.in template for pcre_stringpiece.h, the header for the |
| 647 |
|
C++ stringpiece functions |
| 648 |
|
pcre_stringpiece.cc source for the C++ stringpiece functions |
| 649 |
|
|
| 650 |
(B) Source files for programs that use PCRE: |
(B) Source files for programs that use PCRE: |
| 651 |
|
|
| 652 |
pcredemo.c simple demonstration of coding calls to PCRE |
pcredemo.c simple demonstration of coding calls to PCRE |
| 653 |
pcregrep.c source of a grep utility that uses PCRE |
pcregrep.c source of a grep utility that uses PCRE |
| 654 |
pcretest.c comprehensive test program |
pcretest.c comprehensive test program |
| 655 |
|
|
| 656 |
(C) Auxiliary files: |
(C) Auxiliary files: |
| 657 |
|
|
| 658 |
132html script to turn "man" pages into HTML |
132html script to turn "man" pages into HTML |
| 659 |
AUTHORS information about the author of PCRE |
AUTHORS information about the author of PCRE |
| 660 |
ChangeLog log of changes to the code |
ChangeLog log of changes to the code |
| 661 |
CleanTxt script to clean nroff output for txt man pages |
CleanTxt script to clean nroff output for txt man pages |
| 662 |
Detrail script to remove trailing spaces |
Detrail script to remove trailing spaces |
| 663 |
Index.html the base HTML page |
HACKING some notes about the internals of PCRE |
| 664 |
INSTALL generic installation instructions |
INSTALL generic installation instructions |
| 665 |
LICENCE conditions for the use of PCRE |
LICENCE conditions for the use of PCRE |
| 666 |
COPYING the same, using GNU's standard name |
COPYING the same, using GNU's standard name |
| 667 |
Makefile.in ) template for Unix Makefile, which is built by |
Makefile.in ) template for Unix Makefile, which is built by |
| 668 |
) "configure" |
) "configure" |
| 669 |
Makefile.am ) the automake input that was used to create |
Makefile.am ) the automake input that was used to create |
| 670 |
) Makefile.in |
) Makefile.in |
| 671 |
NEWS important changes in this release |
NEWS important changes in this release |
| 672 |
NON-UNIX-USE notes on building PCRE on non-Unix systems |
NON-UNIX-USE notes on building PCRE on non-Unix systems |
| 673 |
PrepareRelease script to make preparations for "make dist" |
PrepareRelease script to make preparations for "make dist" |
| 674 |
README this file |
README this file |
| 675 |
RunTest.in template for a Unix shell script for running tests |
RunTest a Unix shell script for running tests |
| 676 |
RunGrepTest.in template for a Unix shell script for pcregrep tests |
RunGrepTest a Unix shell script for pcregrep tests |
| 677 |
aclocal.m4 m4 macros (generated by "aclocal") |
aclocal.m4 m4 macros (generated by "aclocal") |
| 678 |
config.guess ) files used by libtool, |
config.guess ) files used by libtool, |
| 679 |
config.sub ) used only when building a shared library |
config.sub ) used only when building a shared library |
| 680 |
configure a configuring shell script (built by autoconf) |
configure a configuring shell script (built by autoconf) |
| 681 |
configure.ac ) the autoconf input that was used to build |
configure.ac ) the autoconf input that was used to build |
| 682 |
) "configure" and config.h |
) "configure" and config.h |
| 683 |
depcomp ) script to find program dependencies, generated by |
depcomp ) script to find program dependencies, generated by |
| 684 |
) automake |
) automake |
| 685 |
doc/*.3 man page sources for the PCRE functions |
doc/*.3 man page sources for the PCRE functions |
| 686 |
doc/*.1 man page sources for pcregrep and pcretest |
doc/*.1 man page sources for pcregrep and pcretest |
| 687 |
doc/html/* HTML documentation |
doc/index.html.src the base HTML page |
| 688 |
doc/pcre.txt plain text version of the man pages |
doc/html/* HTML documentation |
| 689 |
doc/pcretest.txt plain text documentation of test program |
doc/pcre.txt plain text version of the man pages |
| 690 |
doc/perltest.txt plain text documentation of Perl test program |
doc/pcretest.txt plain text documentation of test program |
| 691 |
install-sh a shell script for installing files |
doc/perltest.txt plain text documentation of Perl test program |
| 692 |
libpcre.pc.in template for libpcre.pc for pkg-config |
install-sh a shell script for installing files |
| 693 |
libpcrecpp.pc.in template for libpcrecpp.pc for pkg-config |
libpcre.pc.in template for libpcre.pc for pkg-config |
| 694 |
ltmain.sh file used to build a libtool script |
libpcrecpp.pc.in template for libpcrecpp.pc for pkg-config |
| 695 |
missing ) common stub for a few missing GNU programs while |
ltmain.sh file used to build a libtool script |
| 696 |
) installing, generated by automake |
missing ) common stub for a few missing GNU programs while |
| 697 |
mkinstalldirs script for making install directories |
) installing, generated by automake |
| 698 |
perltest.pl Perl test program |
mkinstalldirs script for making install directories |
| 699 |
pcre-config.in source of script which retains PCRE information |
perltest.pl Perl test program |
| 700 |
|
pcre-config.in source of script which retains PCRE information |
| 701 |
pcrecpp_unittest.cc ) |
pcrecpp_unittest.cc ) |
| 702 |
pcre_scanner_unittest.cc ) test programs for the C++ wrapper |
pcre_scanner_unittest.cc ) test programs for the C++ wrapper |
| 703 |
pcre_stringpiece_unittest.cc ) |
pcre_stringpiece_unittest.cc ) |
| 704 |
testdata/testinput* test data for main library tests |
testdata/testinput* test data for main library tests |
| 705 |
testdata/testoutput* expected test results |
testdata/testoutput* expected test results |
| 706 |
testdata/grep* input and output for pcregrep tests |
testdata/grep* input and output for pcregrep tests |
| 707 |
|
|
| 708 |
(D) Auxiliary files for cmake support |
(D) Auxiliary files for cmake support |
| 709 |
|
|
| 713 |
(E) Auxiliary files for VPASCAL |
(E) Auxiliary files for VPASCAL |
| 714 |
|
|
| 715 |
makevp.bat |
makevp.bat |
| 716 |
!compile.txt |
makevp_c.txt |
| 717 |
!linklib.txt |
makevp_l.txt |
| 718 |
pcregexp.pas |
pcregexp.pas |
| 719 |
|
|
| 720 |
(F) Auxiliary files for building PCRE "by hand" |
(F) Auxiliary files for building PCRE "by hand" |
| 721 |
|
|
| 722 |
pcre.h.generic ) a version of the public PCRE header file |
pcre.h.generic ) a version of the public PCRE header file |
| 723 |
) for use in non-"configure" environments |
) for use in non-"configure" environments |
| 724 |
config.h.generic ) a version of config.h for use in non-"configure" |
config.h.generic ) a version of config.h for use in non-"configure" |
| 725 |
) environments |
) environments |
| 726 |
|
|
| 727 |
(F) Miscellaneous |
(F) Miscellaneous |
| 728 |
|
|
| 731 |
Philip Hazel |
Philip Hazel |
| 732 |
Email local part: ph10 |
Email local part: ph10 |
| 733 |
Email domain: cam.ac.uk |
Email domain: cam.ac.uk |
| 734 |
Last updated: March 2007 |
Last updated: 17 December 2007 |