@@ -114,12 +114,18 @@ Building PCRE2 using autotools
114114The following instructions assume the use of the widely used "configure; make;
115115make install" (autotools) process.
116116
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
119119to the directory where you want the files to be created. This command is a
120120standard GNU "autoconf" configuration script, for which generic instructions
121121are supplied in the file INSTALL.
122122
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+
123129Most commonly, people build PCRE2 within its own distribution directory, and in
124130this case, on many systems, just running "./configure" is sufficient. However,
125131the usual methods of changing standard defaults are available. For example:
@@ -188,10 +194,10 @@ library. They are also documented in the pcre2build man page.
188194
189195 As well as supporting UTF strings, Unicode support includes support for the
190196 \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).
195201
196202. You can build PCRE2 to recognize either CR or LF or the sequence CRLF, or any
197203 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:
411417. Makefile the makefile that builds the library
412418. src/config.h build-time configuration options for the library
413419. 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
415421 that were set for "configure"
416422. libpcre2-8.pc )
417423. libpcre2-16.pc ) data for the pkg-config command
@@ -571,9 +577,9 @@ at build time" for more details.
571577Making new tarballs
572578-------------------
573579
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.
577583
578584If you have modified any of the man page sources in the doc directory, you
579585should 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.
602608
603609Many (but not all) of the tests that are not skipped are run twice if JIT
604610support 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.
606612
607613The entire set of tests is run once for each of the 8-bit, 16-bit and 32-bit
608614libraries that are enabled. If you want to run just one set of tests, call
609615RunTest with either the -8, -16 or -32 option.
610616
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"
612618on the RunTest command line. To run pcre2test on just one or more specific test
613619files, give their numbers as arguments to RunTest, for example:
614620
@@ -905,4 +911,4 @@ The distribution should contain the files listed below.
905911Philip Hazel
906912Email local part: Philip.Hazel
907913Email domain: gmail.com
908- Last updated: 29 October 2021
914+ Last updated: 15 April 2022
0 commit comments