Lines Matching +full:- +full:- +full:enable +full:- +full:libraries
3 PCRE2 - Perl-compatible regular expressions (revised API)
10 the library in Unix-like environments using the applications known as
22 .\" HTML <a href="NON-AUTOTOOLS-BUILD.txt">
24 \fBNON-AUTOTOOLS-BUILD\fP.
31 file if you are building in a non-Unix-like environment.
34 .SH "PCRE2 BUILD-TIME OPTIONS"
41 same options can be selected in both Unix-like and non-Unix-like environments
47 .\" HTML <a href="NON-AUTOTOOLS-BUILD.txt">
49 \fBNON-AUTOTOOLS-BUILD\fP.
56 ./configure --help
59 begin with --enable or --disable. Because of the way that \fBconfigure\fP
60 works, --enable and --disable always come in pairs, so the complementary option
62 Options that specify values have names that start with --with. At the end of a
66 .SH "BUILDING 8-BIT, 16-BIT AND 32-BIT LIBRARIES"
69 By default, a library called \fBlibpcre2-8\fP is built, containing functions
71 single-byte characters, or UTF-8 strings. You can also build two other
72 libraries, called \fBlibpcre2-16\fP and \fBlibpcre2-32\fP, which process
73 strings that are contained in arrays of 16-bit and 32-bit code units,
74 respectively. These can be interpreted either as single-unit characters or
75 UTF-16/UTF-32 strings. To build these additional libraries, add one or both of
78 --enable-pcre2-16
79 --enable-pcre2-32
81 If you do not want the 8-bit library, add
83 --disable-pcre2-8
85 as well. At least one of the three libraries must be built. Note that the POSIX
86 wrapper is for the 8-bit library only, and that \fBpcre2grep\fP is an 8-bit
87 program. Neither of these are built if you select only the 16-bit or 32-bit
88 libraries.
91 .SH "BUILDING SHARED AND STATIC LIBRARIES"
95 and static libraries by default. You can suppress an unwanted library by adding
98 --disable-shared
99 --disable-static
110 --disable-unicode
112 to the \fBconfigure\fP command. This setting applies to all three libraries. It
116 Of itself, Unicode support does not make PCRE2 treat strings as UTF-8, UTF-16
117 or UTF-32. To do that, applications that use the library can set the PCRE2_UTF
122 UTF support allows the libraries to process character code points up to
143 point in the middle of a multi-code-unit character. The application can lock it
145 \fBpcre2_compile()\fP. There is also a build-time option
147 --enable-never-backslash-C
152 .SH "JUST-IN-TIME COMPILER SUPPORT"
155 Just-in-time (JIT) compiler support is included in the build by specifying
157 --enable-jit
163 --enable-jit=auto
170 --enable-jit-sealloc
180 --disable-pcre2grep-jit
189 of a line. This is the normal newline character on Unix-like systems. You can
192 --enable-newline-is-cr
194 to the \fBconfigure\fP command. There is also an --enable-newline-is-lf option,
198 two-character sequence CRLF (CR immediately followed by LF). If you want this,
201 --enable-newline-is-crlf
205 --enable-newline-is-anycrlf
210 --enable-newline-is-any
217 --enable-newline-is-nul
219 which causes NUL (binary zero) to be set as the default line-ending character.
233 --enable-bsr-anycrlf
245 metacharacter). By default, in the 8-bit and 16-bit libraries, two-byte values
249 patterns, so it is possible to compile PCRE2 to use three-byte or four-byte
252 --with-link-size=3
255 16-bit library, a value of 3 is rounded up to 4. In these libraries, using
257 additional data when handling them. For the 32-bit library the value is always
258 4 and cannot be overridden; the value of --with-link-size is ignored.
274 --with-match-limit=500000
292 --with-heap-limit=500
302 for --with-match-limit. You can set a lower default limit by adding, for
305 --with-match-limit_depth=10000
328 --enable-rebuild-chartables
332 source for new set of tables, created in the default locale of your C run-time
345 8-bit EBCDIC environment by adding
347 --enable-ebcdic --disable-unicode
350 --enable-rebuild-chartables. You should only use it if you know that you are in
353 It is not possible to support both EBCDIC and UTF-8 codes in the same version
354 of the library. Consequently, --enable-unicode and --enable-ebcdic are mutually
361 --enable-ebcdic-nl25
363 as well as, or instead of, --enable-ebcdic. The EBCDIC character for CR has the
368 The options that select newline behaviour, such as --enable-newline-is-cr,
369 and equivalent run-time options, refer to these character values in an EBCDIC
376 By default, on non-Windows systems, \fBpcre2grep\fP supports the use of
383 --disable-pcre2grep-callout to the \fBconfigure\fP command.
393 --enable-pcre2grep-libz
394 --enable-pcre2grep-libbz2
397 relevant libraries are installed on your system. Configuration will fail if
414 --with-pcre2grep-bufsize=51200
415 --with-pcre2grep-max-bufsize=2097152
418 these values by using --buffer-size and --max-buffer-size on the command line.
426 --enable-pcre2test-libreadline
427 --enable-pcre2test-libedit
432 line-editing and history facilities. Note that \fBlibreadline\fP is
433 GPL-licensed, so if you distribute a binary of \fBpcre2test\fP linked in this
437 Setting --enable-pcre2test-libreadline causes the \fB-lreadline\fP option to be
439 sytem-installed readline library this is sufficient. However, in some
451 LIBS="-ncurses"
461 --enable-debug
472 --enable-valgrind
483 code coverage report for its test suite. To enable this, you must install
486 --enable-coverage
498 When --enable-coverage is used, the following addition targets are added to the
504 to running "make coverage-reset", "make coverage-baseline", "make check", and
505 then "make coverage-report".
507 make coverage-reset
511 make coverage-baseline
515 make coverage-report
519 make coverage-clean-report
524 make coverage-clean-data
529 make coverage-clean
542 --enable-fuzz-support
544 At present this applies only to the 8-bit library. If set, it causes an extra
545 library called libpcre2-fuzzsupport.a to be built, but not installed. This
552 Setting --enable-fuzz-support also causes a binary called \fBpcre2fuzzcheck\fP
568 --disable-stack-for-recursion
577 \fBpcre2api\fP(3), \fBpcre2-config\fP(3).
595 Copyright (c) 1997-2018 University of Cambridge.