@@ -114,12 +114,18 @@ Building PCRE2 using autotools
114
114
The following instructions assume the use of the widely used "configure; make;
115
115
make install" (autotools) process.
116
116
117
- To build PCRE2 on system that supports autotools, first run the "configure"
118
- command from the PCRE2 distribution directory, with your current directory set
117
+ If you have downloaded and unpacked a PCRE2 release tarball, run the
118
+ "configure" command from the PCRE2 directory, with your current directory set
119
119
to the directory where you want the files to be created. This command is a
120
120
standard GNU "autoconf" configuration script, for which generic instructions
121
121
are supplied in the file INSTALL.
122
122
123
+ The files in the GitHub repository do not contain "configure". If you have
124
+ downloaded the PCRE2 source files from GitHub, before you can run "configure"
125
+ you must run the shell script called autogen.sh. This runs a number of
126
+ autotools to create a "configure" script (you must of course have the autotools
127
+ commands installed in order to do this).
128
+
123
129
Most commonly, people build PCRE2 within its own distribution directory, and in
124
130
this case, on many systems, just running "./configure" is sufficient. However,
125
131
the usual methods of changing standard defaults are available. For example:
@@ -188,10 +194,10 @@ library. They are also documented in the pcre2build man page.
188
194
189
195
As well as supporting UTF strings, Unicode support includes support for the
190
196
\P, \p, and \X sequences that recognize Unicode character properties.
191
- However, only the basic two-letter properties such as Lu are supported.
192
- Escape sequences such as \d and \w in patterns do not by default make use of
193
- Unicode properties, but can be made to do so by setting the PCRE2_UCP option
194
- or starting a pattern with (*UCP).
197
+ However, only a subset of Unicode properties are supported; see the
198
+ pcre2pattern man page for details. Escape sequences such as \d and \w in
199
+ patterns do not by default make use of Unicode properties, but can be made to
200
+ do so by setting the PCRE2_UCP option or starting a pattern with (*UCP).
195
201
196
202
. You can build PCRE2 to recognize either CR or LF or the sequence CRLF, or any
197
203
of the preceding, or any of the Unicode newline sequences, or the NUL (zero)
@@ -411,7 +417,7 @@ The "configure" script builds the following files for the basic C library:
411
417
. Makefile the makefile that builds the library
412
418
. src/config.h build-time configuration options for the library
413
419
. src/pcre2.h the public PCRE2 header file
414
- . pcre2-config script that shows the building settings such as CFLAGS
420
+ . pcre2-config script that shows the building settings such as CFLAGS
415
421
that were set for "configure"
416
422
. libpcre2-8.pc )
417
423
. libpcre2-16.pc ) data for the pkg-config command
@@ -571,9 +577,9 @@ at build time" for more details.
571
577
Making new tarballs
572
578
-------------------
573
579
574
- The command "make dist" creates two PCRE2 tarballs, in tar.gz and zip formats.
575
- The command "make distcheck" does the same, but then does a trial build of the
576
- new distribution to ensure that it works.
580
+ The command "make dist" creates three PCRE2 tarballs, in tar.gz, tar.bz2, and
581
+ zip formats. The command "make distcheck" does the same, but then does a trial
582
+ build of the new distribution to ensure that it works.
577
583
578
584
If you have modified any of the man page sources in the doc directory, you
579
585
should first run the PrepareRelease script before making a distribution. This
@@ -602,13 +608,13 @@ is available. RunTest outputs a comment when it skips a test.
602
608
603
609
Many (but not all) of the tests that are not skipped are run twice if JIT
604
610
support is available. On the second run, JIT compilation is forced. This
605
- testing can be suppressed by putting "nojit" on the RunTest command line.
611
+ testing can be suppressed by putting "- nojit" on the RunTest command line.
606
612
607
613
The entire set of tests is run once for each of the 8-bit, 16-bit and 32-bit
608
614
libraries that are enabled. If you want to run just one set of tests, call
609
615
RunTest with either the -8, -16 or -32 option.
610
616
611
- If valgrind is installed, you can run the tests under it by putting "valgrind"
617
+ If valgrind is installed, you can run the tests under it by putting "- valgrind"
612
618
on the RunTest command line. To run pcre2test on just one or more specific test
613
619
files, give their numbers as arguments to RunTest, for example:
614
620
@@ -905,4 +911,4 @@ The distribution should contain the files listed below.
905
911
Philip Hazel
906
912
Email local part: Philip.Hazel
907
913
Email domain: gmail.com
908
- Last updated: 29 October 2021
914
+ Last updated: 15 April 2022
0 commit comments