Lines Matching +full:autotools +full:- +full:options
17 <li><a name="TOC2" href="#SEC2">PCRE2 BUILD-TIME OPTIONS</a>
18 <li><a name="TOC3" href="#SEC3">BUILDING 8-BIT, 16-BIT AND 32-BIT LIBRARIES</a>
22 <li><a name="TOC7" href="#SEC7">JUST-IN-TIME COMPILER SUPPORT</a>
30 <li><a name="TOC15" href="#SEC15">PCRE2GREP OPTIONS FOR COMPRESSED FILE SUPPORT</a>
46 the library in Unix-like environments using the applications known as
47 Autotools. Also in the distribution are files to support building using
50 contains general information about building with Autotools (some of which is
53 Autotools (including information about using <b>CMake</b> and building "by
55 <a href="NON-AUTOTOOLS-BUILD.txt"><b>NON-AUTOTOOLS-BUILD</b>.</a>
58 file if you are building in a non-Unix-like environment.
60 <br><a name="SEC2" href="#TOC1">PCRE2 BUILD-TIME OPTIONS</a><br>
65 options to <b>configure</b> before running the <b>make</b> command. However, the
66 same options can be selected in both Unix-like and non-Unix-like environments
70 If you are not using Autotools or <b>CMake</b>, option selection can be done by
73 <a href="NON-AUTOTOOLS-BUILD.txt"><b>NON-AUTOTOOLS-BUILD</b>.</a>
76 The complete list of options for <b>configure</b> (which includes the standard
80 ./configure --help
82 The following sections include descriptions of "on/off" options whose names
83 begin with --enable or --disable. Because of the way that <b>configure</b>
84 works, --enable and --disable always come in pairs, so the complementary option
86 Options that specify values have names that start with --with. At the end of a
89 <br><a name="SEC3" href="#TOC1">BUILDING 8-BIT, 16-BIT AND 32-BIT LIBRARIES</a><br>
91 By default, a library called <b>libpcre2-8</b> is built, containing functions
93 single-byte characters, or UTF-8 strings. You can also build two other
94 libraries, called <b>libpcre2-16</b> and <b>libpcre2-32</b>, which process
95 strings that are contained in arrays of 16-bit and 32-bit code units,
96 respectively. These can be interpreted either as single-unit characters or
97 UTF-16/UTF-32 strings. To build these additional libraries, add one or both of
100 --enable-pcre2-16
101 --enable-pcre2-32
103 If you do not want the 8-bit library, add
105 --disable-pcre2-8
108 wrapper is for the 8-bit library only, and that <b>pcre2grep</b> is an 8-bit
109 program. Neither of these are built if you select only the 16-bit or 32-bit
114 The Autotools PCRE2 building process uses <b>libtool</b> to build both shared
118 --disable-shared
119 --disable-static
128 --disable-unicode
135 Of itself, Unicode support does not make PCRE2 treat strings as UTF-8, UTF-16
136 or UTF-32. To do that, applications that use the library can set the PCRE2_UTF
146 script names, and some bi-directional properties are supported. Details are
161 point in the middle of a multi-code-unit character. The application can lock it
163 <b>pcre2_compile()</b>. There is also a build-time option
165 --enable-never-backslash-C
169 <br><a name="SEC7" href="#TOC1">JUST-IN-TIME COMPILER SUPPORT</a><br>
171 Just-in-time (JIT) compiler support is included in the build by specifying
173 --enable-jit
179 --enable-jit=auto
186 --enable-jit-sealloc
194 --disable-pcre2grep-jit
201 of a line. This is the normal newline character on Unix-like systems. You can
204 --enable-newline-is-cr
206 to the <b>configure</b> command. There is also an --enable-newline-is-lf option,
211 two-character sequence CRLF (CR immediately followed by LF). If you want this,
214 --enable-newline-is-crlf
218 --enable-newline-is-anycrlf
223 --enable-newline-is-any
230 --enable-newline-is-nul
232 which causes NUL (binary zero) to be set as the default line-ending character.
245 --enable-bsr-anycrlf
255 metacharacter). By default, in the 8-bit and 16-bit libraries, two-byte values
259 patterns, so it is possible to compile PCRE2 to use three-byte or four-byte
262 --with-link-size=3
265 16-bit library, a value of 3 is rounded up to 4. In these libraries, using
267 additional data when handling them. For the 32-bit library the value is always
268 4 and cannot be overridden; the value of --with-link-size is ignored.
280 --with-match-limit=500000
296 --with-heap-limit=500
307 for --with-match-limit. You can set a lower default limit by adding, for
310 --with-match-limit-depth=10000
332 --enable-rebuild-chartables
337 C run-time system. This method of replacing the tables does not work if you are
348 cc src/pcre2_dftables.c -o pcre2_dftables
352 specify a locale, you must use the -L option:
354 LC_ALL=fr_FR ./pcre2_dftables -L src/pcre2_chartables.c
356 You can also specify -b (with or without -L). This causes the tables to be
369 8-bit EBCDIC environment by adding
371 --enable-ebcdic --disable-unicode
374 --enable-rebuild-chartables. You should only use it if you know that you are in
378 It is not possible to support both EBCDIC and UTF-8 codes in the same version
379 of the library. Consequently, --enable-unicode and --enable-ebcdic are mutually
387 --enable-ebcdic-nl25
389 as well as, or instead of, --enable-ebcdic. The EBCDIC character for CR has the
395 The options that select newline behaviour, such as --enable-newline-is-cr,
396 and equivalent run-time options, refer to these character values in an EBCDIC
404 If --disable-pcre2grep-callout-fork is added to the <b>configure</b> command,
405 only the first kind of callout is supported; if --disable-pcre2grep-callout is
411 <br><a name="SEC15" href="#TOC1">PCRE2GREP OPTIONS FOR COMPRESSED FILE SUPPORT</a><br>
417 --enable-pcre2grep-libz
418 --enable-pcre2grep-libbz2
420 to the <b>configure</b> command. These options naturally require that the
436 --with-pcre2grep-bufsize=51200
437 --with-pcre2grep-max-bufsize=2097152
440 these values by using --buffer-size and --max-buffer-size on the command line.
446 --enable-pcre2test-libreadline
447 --enable-pcre2test-libedit
452 line-editing and history facilities. Note that <b>libreadline</b> is
453 GPL-licensed, so if you distribute a binary of <b>pcre2test</b> linked in this
458 Setting --enable-pcre2test-libreadline causes the <b>-lreadline</b> option to be
460 sytem-installed readline library this is sufficient. However, in some
472 LIBS="-ncurses"
480 --enable-debug
489 --enable-valgrind
501 --enable-coverage
515 When --enable-coverage is used, the following addition targets are added to the
521 to running "make coverage-reset", "make coverage-baseline", "make check", and
522 then "make coverage-report".
524 make coverage-reset
528 make coverage-baseline
532 make coverage-report
536 make coverage-clean-report
541 make coverage-clean-data
546 make coverage-clean
562 --disable-percent-zt
572 --enable-fuzz-support
574 At present this applies only to the 8-bit library. If set, it causes an extra
575 library called libpcre2-fuzzsupport.a to be built, but not installed. This
579 This is done both with no options and with some random options bits that are
583 Setting --enable-fuzz-support also causes a binary called <b>pcre2fuzzcheck</b>
597 --disable-stack-for-recursion
605 <b>pcre2api</b>(3), <b>pcre2-config</b>(3).
620 Copyright © 1997-2022 University of Cambridge.