/[pcre]/code/trunk/README
ViewVC logotype

Diff of /code/trunk/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1055 by chpe, Tue Oct 16 15:53:30 2012 UTC revision 1251 by ph10, Wed Feb 20 17:42:03 2013 UTC
# Line 186  library. They are also documented in the Line 186  library. They are also documented in the
186  . By default, only the 8-bit library is built. If you add --enable-pcre16 to  . By default, only the 8-bit library is built. If you add --enable-pcre16 to
187    the "configure" command, the 16-bit library is also built. If you add    the "configure" command, the 16-bit library is also built. If you add
188    --enable-pcre32 to the "configure" command, the 32-bit library is also built.    --enable-pcre32 to the "configure" command, the 32-bit library is also built.
189    If you want only the 16-bit or 32-bit library, --disable-pcre8 to disable    If you want only the 16-bit or 32-bit library, use --disable-pcre8 to disable
190    building the 8-bit library.    building the 8-bit library.
191    
192  . If you are building the 8-bit library and want to suppress the building of  . If you are building the 8-bit library and want to suppress the building of
# Line 322  library. They are also documented in the Line 322  library. They are also documented in the
322    This automatically implies --enable-rebuild-chartables (see above). However,    This automatically implies --enable-rebuild-chartables (see above). However,
323    when PCRE is built this way, it always operates in EBCDIC. It cannot support    when PCRE is built this way, it always operates in EBCDIC. It cannot support
324    both EBCDIC and UTF-8/16/32. There is a second option, --enable-ebcdic-nl25,    both EBCDIC and UTF-8/16/32. There is a second option, --enable-ebcdic-nl25,
325    which specifies that the code value for the EBCDIC NL character is 0x25    which specifies that the code value for the EBCDIC NL character is 0x25
326    instead of the default 0x15.    instead of the default 0x15.
327    
328    . In environments where valgrind is installed, if you specify
329    
330      --enable-valgrind
331    
332      PCRE will use valgrind annotations to mark certain memory regions as
333      unaddressable. This allows it to detect invalid memory accesses, and is
334      mostly useful for debugging PCRE itself.
335    
336    . In environments where the gcc compiler is used and lcov version 1.6 or above
337      is installed, if you specify
338    
339      --enable-coverage
340    
341      the build process implements a code coverage report for the test suite. The
342      report is generated by running "make coverage". If ccache is installed on
343      your system, it must be disabled when building PCRE for coverage reporting.
344      You can do this by setting the environment variable CCACHE_DISABLE=1 before
345      running "make" to build PCRE.
346    
347  . The pcregrep program currently supports only 8-bit data files, and so  . The pcregrep program currently supports only 8-bit data files, and so
348    requires the 8-bit PCRE library. It is possible to compile pcregrep to use    requires the 8-bit PCRE library. It is possible to compile pcregrep to use
# Line 614  run forces pcre_study() to be called for Line 633  run forces pcre_study() to be called for
633  tests that are marked "never study" (see the pcretest program for how this is  tests that are marked "never study" (see the pcretest program for how this is
634  done). If JIT support is available, the non-DFA tests are run a third time,  done). If JIT support is available, the non-DFA tests are run a third time,
635  this time with a forced pcre_study() with the PCRE_STUDY_JIT_COMPILE option.  this time with a forced pcre_study() with the PCRE_STUDY_JIT_COMPILE option.
636    This testing can be suppressed by putting "nojit" on the RunTest command line.
637    
638  The entire set of tests is run once for each of the 8-bit, 16-bit and 32-bit  The entire set of tests is run once for each of the 8-bit, 16-bit and 32-bit
639  libraries that are enabled. If you want to run just one set of tests, call  libraries that are enabled. If you want to run just one set of tests, call
640  RunTest with either the -8, -16 or -32 option.  RunTest with either the -8, -16 or -32 option.
641    
642    If valgrind is installed, you can run the tests under it by putting "valgrind"
643    on the RunTest command line.
644    
645  RunTest uses a file called testtry to hold the main output from pcretest.  RunTest uses a file called testtry to hold the main output from pcretest.
646  Other files whose names begin with "test" are used as working files in some  Other files whose names begin with "test" are used as working files in some
647  tests. To run pcretest on just one or more specific test files, give their  tests. To run pcretest on just one or more specific test files, give their
# Line 913  pcre_xxx, one with the name pcre16_xx, a Line 936  pcre_xxx, one with the name pcre16_xx, a
936  Philip Hazel  Philip Hazel
937  Email local part: ph10  Email local part: ph10
938  Email domain: cam.ac.uk  Email domain: cam.ac.uk
939  Last updated: 07 September 2012  Last updated: 20 February 2013

Legend:
Removed from v.1055  
changed lines
  Added in v.1251

  ViewVC Help
Powered by ViewVC 1.1.5