Lines Matching +full:tests +full:- +full:coverage +full:- +full:reporting

3 PCRE2 - Perl-compatible regular expressions (revised API)
10 the library in Unix-like environments using the applications known as
23 .\" HTML <a href="NON-AUTOTOOLS-BUILD.txt">
25 \fBNON-AUTOTOOLS-BUILD\fP.
32 file if you are building in a non-Unix-like environment.
35 .SH "PCRE2 BUILD-TIME OPTIONS"
42 same options can be selected in both Unix-like and non-Unix-like environments
48 .\" HTML <a href="NON-AUTOTOOLS-BUILD.txt">
50 \fBNON-AUTOTOOLS-BUILD\fP.
57 ./configure --help
60 begin with --enable or --disable. Because of the way that \fBconfigure\fP
61 works, --enable and --disable always come in pairs, so the complementary option
63 Options that specify values have names that start with --with. At the end of a
67 .SH "BUILDING 8-BIT, 16-BIT AND 32-BIT LIBRARIES"
70 By default, a library called \fBlibpcre2-8\fP is built, containing functions
72 single-byte characters, or UTF-8 strings. You can also build two other
73 libraries, called \fBlibpcre2-16\fP and \fBlibpcre2-32\fP, which process
74 strings that are contained in arrays of 16-bit and 32-bit code units,
75 respectively. These can be interpreted either as single-unit characters or
76 UTF-16/UTF-32 strings. To build these additional libraries, add one or both of
79 --enable-pcre2-16
80 --enable-pcre2-32
82 If you do not want the 8-bit library, add
84 --disable-pcre2-8
87 wrapper is for the 8-bit library only, and that \fBpcre2grep\fP is an 8-bit
88 program. Neither of these are built if you select only the 16-bit or 32-bit
99 --disable-shared
100 --disable-static
102 to the \fBconfigure\fP command. Setting --disable-shared ensures that PCRE2
109 LDFLAGS=--static ./configure --disable-shared
111 Note the two hyphens in --static. Of course, this works only if static versions
121 --disable-unicode
127 Of itself, Unicode support does not make PCRE2 treat strings as UTF-8, UTF-16
128 or UTF-32. To do that, applications that use the library can set the PCRE2_UTF
137 script names, and some bi-directional properties are supported. Details are
155 point in the middle of a multi-code-unit character. The application can lock it
157 \fBpcre2_compile()\fP. There is also a build-time option
159 --enable-never-backslash-C
164 .SH "JUST-IN-TIME COMPILER SUPPORT"
167 Just-in-time (JIT) compiler support is included in the build by specifying
169 --enable-jit
175 --enable-jit=auto
182 --enable-jit-sealloc
192 --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 \fBconfigure\fP command. There is also an --enable-newline-is-lf option,
210 two-character sequence CRLF (CR immediately followed by LF). If you want this,
213 --enable-newline-is-crlf
217 --enable-newline-is-anycrlf
222 --enable-newline-is-any
229 --enable-newline-is-nul
231 which causes NUL (binary zero) to be set as the default line-ending character.
245 --enable-bsr-anycrlf
257 metacharacter). By default, in the 8-bit and 16-bit libraries, two-byte values
261 patterns, so it is possible to compile PCRE2 to use three-byte or four-byte
264 --with-link-size=3
267 16-bit library, a value of 3 is rounded up to 4. In these libraries, using
269 additional data when handling them. For the 32-bit library the value is always
270 4 and cannot be overridden; the value of --with-link-size is ignored.
286 --with-match-limit=500000
303 --with-heap-limit=500
313 for --with-match-limit. You can set a lower default limit by adding, for
316 --with-match-limit-depth=10000
331 .SH "LIMITING VARIABLE-LENGTH LOOKBEHIND ASSERTIONS"
336 top-level branch. There is a limit to this maximum that defaults to 255
339 --with-max-varlookbehind=100
356 --enable-rebuild-chartables
361 C run-time system. This method of replacing the tables does not work if you are
371 cc src/pcre2_dftables.c -o pcre2_dftables
375 specify a locale, you must use the -L option:
377 LC_ALL=fr_FR ./pcre2_dftables -L src/pcre2_chartables.c
379 You can also specify -b (with or without -L). This causes the tables to be
394 8-bit EBCDIC environment by adding
396 --enable-ebcdic --disable-unicode
399 --enable-rebuild-chartables. You should only use it if you know that you are in
402 It is not possible to support both EBCDIC and UTF-8 codes in the same version
403 of the library. Consequently, --enable-unicode and --enable-ebcdic are mutually
410 --enable-ebcdic-nl25
412 as well as, or instead of, --enable-ebcdic. The EBCDIC character for CR has the
417 The options that select newline behaviour, such as --enable-newline-is-cr,
418 and equivalent run-time options, refer to these character values in an EBCDIC
428 If --disable-pcre2grep-callout-fork is added to the \fBconfigure\fP command,
429 only the first kind of callout is supported; if --disable-pcre2grep-callout is
445 --enable-pcre2grep-libz
446 --enable-pcre2grep-libbz2
466 --with-pcre2grep-bufsize=51200
467 --with-pcre2grep-max-bufsize=2097152
470 these values by using --buffer-size and --max-buffer-size on the command line.
478 --enable-pcre2test-libreadline
479 --enable-pcre2test-libedit
484 line-editing and history facilities. Note that \fBlibreadline\fP is
485 GPL-licensed, so if you distribute a binary of \fBpcre2test\fP linked in this
489 Setting --enable-pcre2test-libreadline causes the \fB-lreadline\fP option to be
491 system-installed readline library this is sufficient. However, in some
503 LIBS="-ncurses"
513 --enable-debug
524 --enable-valgrind
531 .SH "CODE COVERAGE REPORTING"
535 code coverage report for its test suite. To enable this, you must install
538 --enable-coverage
543 coverage reporting. If you have configured \fBccache\fP to run automatically
550 When --enable-coverage is used, the following addition targets are added to the
553 make coverage
555 This creates a fresh coverage report for the PCRE2 test suite. It is equivalent
556 to running "make coverage-reset", "make coverage-baseline", "make check", and
557 then "make coverage-report".
559 make coverage-reset
561 This zeroes the coverage counters, but does nothing else.
563 make coverage-baseline
565 This captures baseline coverage information.
567 make coverage-report
569 This creates the coverage report.
571 make coverage-clean-report
573 This removes the generated coverage report without cleaning the coverage data
576 make coverage-clean-data
578 This removes the captured coverage data without removing the coverage files
581 make coverage-clean
583 This cleans all coverage data including the generated coverage report. For more
584 information about code coverage, see the \fBgcov\fP and \fBlcov\fP
599 --disable-percent-zt
608 There is a special option for use by people who want to run fuzzing tests on
611 --enable-fuzz-support
613 At present this applies only to the 8-bit library. If set, it causes an extra
614 library called libpcre2-fuzzsupport.a to be built, but not installed. This
621 Setting --enable-fuzz-support also causes a binary called \fBpcre2fuzzcheck\fP
637 --disable-stack-for-recursion
646 \fBpcre2api\fP(3), \fBpcre2-config\fP(3).
664 Copyright (c) 1997-2024 University of Cambridge.