| 173 |
--disable-cpp to the "configure" command. Otherwise, when "configure" is run, |
--disable-cpp to the "configure" command. Otherwise, when "configure" is run, |
| 174 |
it will try to find a C++ compiler and C++ header files, and if it succeeds, |
it will try to find a C++ compiler and C++ header files, and if it succeeds, |
| 175 |
it will try to build the C++ wrapper. |
it will try to build the C++ wrapper. |
| 176 |
|
|
| 177 |
. If you want to include support for just-in-time compiling, which can give |
. If you want to include support for just-in-time compiling, which can give |
| 178 |
large performance improvements on certain platforms, add --enable-jit to the |
large performance improvements on certain platforms, add --enable-jit to the |
| 179 |
"configure" command. This support is available only for certain hardware |
"configure" command. This support is available only for certain hardware |
| 180 |
architectures. If you try to enable it on an unsupported architecture, there |
architectures. If you try to enable it on an unsupported architecture, there |
| 181 |
will be a compile time error. |
will be a compile time error. |
| 182 |
|
|
| 183 |
. When JIT support is enabled, pcregrep automatically makes use of it, unless |
. When JIT support is enabled, pcregrep automatically makes use of it, unless |
| 184 |
you add --disable-pcregrep-jit to the "configure" command. |
you add --disable-pcregrep-jit to the "configure" command. |
| 185 |
|
|
| 186 |
. If you want to make use of the support for UTF-8 Unicode character strings in |
. If you want to make use of the support for UTF-8 Unicode character strings in |
| 187 |
PCRE, you must add --enable-utf8 to the "configure" command. Without it, the |
PCRE, you must add --enable-utf8 to the "configure" command. Without it, the |
| 355 |
|
|
| 356 |
Once "configure" has run, you can run "make". It builds two libraries, called |
Once "configure" has run, you can run "make". It builds two libraries, called |
| 357 |
libpcre and libpcreposix, a test program called pcretest, and the pcregrep |
libpcre and libpcreposix, a test program called pcretest, and the pcregrep |
| 358 |
command. If a C++ compiler was found on your system, and you did not disable it |
command. If a C++ compiler was found on your system, and you did not disable it |
| 359 |
with --disable-cpp, "make" also builds the C++ wrapper library, which is called |
with --disable-cpp, "make" also builds the C++ wrapper library, which is called |
| 360 |
libpcrecpp, and some test programs called pcrecpp_unittest, |
libpcrecpp, and some test programs called pcrecpp_unittest, |
| 361 |
pcre_scanner_unittest, and pcre_stringpiece_unittest. If you enabled JIT |
pcre_scanner_unittest, and pcre_stringpiece_unittest. If you enabled JIT |
| 362 |
support with --enable-jit, a test program called pcre_jit_test is also built. |
support with --enable-jit, a test program called pcre_jit_test is also built. |
| 363 |
|
|
| 364 |
The command "make check" runs all the appropriate tests. Details of the PCRE |
The command "make check" runs all the appropriate tests. Details of the PCRE |
| 394 |
Man pages (share/man/man{1,3}): |
Man pages (share/man/man{1,3}): |
| 395 |
pcregrep.1 |
pcregrep.1 |
| 396 |
pcretest.1 |
pcretest.1 |
| 397 |
pcre-config.1 |
pcre-config.1 |
| 398 |
pcre.3 |
pcre.3 |
| 399 |
pcre*.3 (lots more pages, all starting "pcre") |
pcre*.3 (lots more pages, all starting "pcre") |
| 400 |
|
|
| 412 |
pcre.txt (a concatenation of the man(3) pages) |
pcre.txt (a concatenation of the man(3) pages) |
| 413 |
pcretest.txt the pcretest man page |
pcretest.txt the pcretest man page |
| 414 |
pcregrep.txt the pcregrep man page |
pcregrep.txt the pcregrep man page |
| 415 |
pcre-config.txt the pcre-config man page |
pcre-config.txt the pcre-config man page |
| 416 |
|
|
| 417 |
If you want to remove PCRE from your system, you can run "make uninstall". |
If you want to remove PCRE from your system, you can run "make uninstall". |
| 418 |
This removes all the files that "make install" installed. However, it does not |
This removes all the files that "make install" installed. However, it does not |
| 548 |
created by the configuring process. There is also a script called RunGrepTest |
created by the configuring process. There is also a script called RunGrepTest |
| 549 |
that tests the options of the pcregrep command. If the C++ wrapper library is |
that tests the options of the pcregrep command. If the C++ wrapper library is |
| 550 |
built, three test programs called pcrecpp_unittest, pcre_scanner_unittest, and |
built, three test programs called pcrecpp_unittest, pcre_scanner_unittest, and |
| 551 |
pcre_stringpiece_unittest are also built. When JIT support is enabled, another |
pcre_stringpiece_unittest are also built. When JIT support is enabled, another |
| 552 |
test program called pcre_jit_test is built. |
test program called pcre_jit_test is built. |
| 553 |
|
|
| 554 |
Both the scripts and all the program tests are run if you obey "make check" or |
Both the scripts and all the program tests are run if you obey "make check" or |
| 561 |
were selected. For example, the tests for UTF-8 support are run only if |
were selected. For example, the tests for UTF-8 support are run only if |
| 562 |
--enable-utf8 was used. RunTest outputs a comment when it skips a test. |
--enable-utf8 was used. RunTest outputs a comment when it skips a test. |
| 563 |
|
|
| 564 |
Many of the tests that are not skipped are run up to three times. The second |
Many of the tests that are not skipped are run up to three times. The second |
| 565 |
run forces pcre_study() to be called for all patterns except for a few in some |
run forces pcre_study() to be called for all patterns except for a few in some |
| 566 |
tests that are marked "never study" (see the pcretest program for how this is |
tests that are marked "never study" (see the pcretest program for how this is |
| 567 |
done). If JIT support is available, the non-DFA tests are run a third time, |
done). If JIT support is available, the non-DFA tests are run a third time, |
| 568 |
this time with a forced pcre_study() with the PCRE_STUDY_JIT_COMPILE option. |
this time with a forced pcre_study() with the PCRE_STUDY_JIT_COMPILE option. |
| 569 |
|
|
| 570 |
RunTest uses a file called testtry to hold the main output from pcretest |
RunTest uses a file called testtry to hold the main output from pcretest |
| 638 |
The thirteenth test checks a number internals and non-Perl features concerned |
The thirteenth test checks a number internals and non-Perl features concerned |
| 639 |
with Unicode property support. |
with Unicode property support. |
| 640 |
|
|
| 641 |
The fourteenth test is run only when JIT support is available, and the |
The fourteenth test is run only when JIT support is available, and the |
| 642 |
fifteenth test is run only when JIT support is not available. They test some |
fifteenth test is run only when JIT support is not available. They test some |
| 643 |
JIT-specific features such as information output from pcretest about JIT |
JIT-specific features such as information output from pcretest about JIT |
| 644 |
compilation. |
compilation. |
| 645 |
|
|
| 646 |
|
|
| 721 |
pcre_get.c ) sources for the functions in the library, |
pcre_get.c ) sources for the functions in the library, |
| 722 |
pcre_globals.c ) and some internal functions that they use |
pcre_globals.c ) and some internal functions that they use |
| 723 |
pcre_info.c ) |
pcre_info.c ) |
| 724 |
pcre_jit_compile.c ) |
pcre_jit_compile.c ) |
| 725 |
pcre_maketables.c ) |
pcre_maketables.c ) |
| 726 |
pcre_newline.c ) |
pcre_newline.c ) |
| 727 |
pcre_ord2utf8.c ) |
pcre_ord2utf8.c ) |
| 738 |
pcre.h.in template for pcre.h when built by "configure" |
pcre.h.in template for pcre.h when built by "configure" |
| 739 |
pcreposix.h header for the external POSIX wrapper API |
pcreposix.h header for the external POSIX wrapper API |
| 740 |
pcre_internal.h header for internal use |
pcre_internal.h header for internal use |
| 741 |
sljit/* 16 files that make up the JIT compiler |
sljit/* 16 files that make up the JIT compiler |
| 742 |
ucp.h header for Unicode property handling |
ucp.h header for Unicode property handling |
| 743 |
|
|
| 744 |
config.h.in template for config.h, which is built by "configure" |
config.h.in template for config.h, which is built by "configure" |
| 805 |
mkinstalldirs script for making install directories |
mkinstalldirs script for making install directories |
| 806 |
perltest.pl Perl test program |
perltest.pl Perl test program |
| 807 |
pcre-config.in source of script which retains PCRE information |
pcre-config.in source of script which retains PCRE information |
| 808 |
pcre_jit_test.c test program for the JIT compiler |
pcre_jit_test.c test program for the JIT compiler |
| 809 |
pcrecpp_unittest.cc ) |
pcrecpp_unittest.cc ) |
| 810 |
pcre_scanner_unittest.cc ) test programs for the C++ wrapper |
pcre_scanner_unittest.cc ) test programs for the C++ wrapper |
| 811 |
pcre_stringpiece_unittest.cc ) |
pcre_stringpiece_unittest.cc ) |