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

Diff of /code/trunk/README

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

revision 685 by ph10, Tue Sep 6 15:02:07 2011 UTC revision 691 by ph10, Sun Sep 11 14:31:21 2011 UTC
# Line 173  library. They are also documented in the Line 173  library. They are also documented in the
173    --disable-cpp to the "configure" command. Otherwise, when "configure" is run,    --disable-cpp to the "configure" command. Otherwise, when "configure" is run,
174    it will try to find a C++ compiler and C++ header files, and if it succeeds,    it will try to find a C++ compiler and C++ header files, and if it succeeds,
175    it will try to build the C++ wrapper.    it will try to build the C++ wrapper.
176    
177  . If you want to include support for just-in-time compiling, which can give  . If you want to include support for just-in-time compiling, which can give
178    large performance improvements on certain platforms, add --enable-jit to the    large performance improvements on certain platforms, add --enable-jit to the
179    "configure" command. This support is available only for certain hardware    "configure" command. This support is available only for certain hardware
180    architectures. If you try to enable it on an unsupported architecture, there    architectures. If you try to enable it on an unsupported architecture, there
181    will be a compile time error.    will be a compile time error.
182    
183  . When JIT support is enabled, pcregrep automatically makes use of it, unless  . When JIT support is enabled, pcregrep automatically makes use of it, unless
184    you add --disable-pcregrep-jit to the "configure" command.    you add --disable-pcregrep-jit to the "configure" command.
185    
186  . If you want to make use of the support for UTF-8 Unicode character strings in  . If you want to make use of the support for UTF-8 Unicode character strings in
187    PCRE, you must add --enable-utf8 to the "configure" command. Without it, the    PCRE, you must add --enable-utf8 to the "configure" command. Without it, the
# Line 355  contains compiler output from tests that Line 355  contains compiler output from tests that
355    
356  Once "configure" has run, you can run "make". It builds two libraries, called  Once "configure" has run, you can run "make". It builds two libraries, called
357  libpcre and libpcreposix, a test program called pcretest, and the pcregrep  libpcre and libpcreposix, a test program called pcretest, and the pcregrep
358  command. If a C++ compiler was found on your system, and you did not disable it  command. If a C++ compiler was found on your system, and you did not disable it
359  with --disable-cpp, "make" also builds the C++ wrapper library, which is called  with --disable-cpp, "make" also builds the C++ wrapper library, which is called
360  libpcrecpp, and some test programs called pcrecpp_unittest,  libpcrecpp, and some test programs called pcrecpp_unittest,
361  pcre_scanner_unittest, and pcre_stringpiece_unittest. If you enabled JIT  pcre_scanner_unittest, and pcre_stringpiece_unittest. If you enabled JIT
362  support with --enable-jit, a test program called pcre_jit_test is also built.  support with --enable-jit, a test program called pcre_jit_test is also built.
363    
364  The command "make check" runs all the appropriate tests. Details of the PCRE  The command "make check" runs all the appropriate tests. Details of the PCRE
# Line 394  system. The following are installed (fil Line 394  system. The following are installed (fil
394    Man pages (share/man/man{1,3}):    Man pages (share/man/man{1,3}):
395      pcregrep.1      pcregrep.1
396      pcretest.1      pcretest.1
397      pcre-config.1      pcre-config.1
398      pcre.3      pcre.3
399      pcre*.3 (lots more pages, all starting "pcre")      pcre*.3 (lots more pages, all starting "pcre")
400    
# Line 412  system. The following are installed (fil Line 412  system. The following are installed (fil
412      pcre.txt         (a concatenation of the man(3) pages)      pcre.txt         (a concatenation of the man(3) pages)
413      pcretest.txt     the pcretest man page      pcretest.txt     the pcretest man page
414      pcregrep.txt     the pcregrep man page      pcregrep.txt     the pcregrep man page
415      pcre-config.txt  the pcre-config man page      pcre-config.txt  the pcre-config man page
416    
417  If you want to remove PCRE from your system, you can run "make uninstall".  If you want to remove PCRE from your system, you can run "make uninstall".
418  This removes all the files that "make install" installed. However, it does not  This removes all the files that "make install" installed. However, it does not
# Line 548  To test the basic PCRE library on a Unix Line 548  To test the basic PCRE library on a Unix
548  created by the configuring process. There is also a script called RunGrepTest  created by the configuring process. There is also a script called RunGrepTest
549  that tests the options of the pcregrep command. If the C++ wrapper library is  that tests the options of the pcregrep command. If the C++ wrapper library is
550  built, three test programs called pcrecpp_unittest, pcre_scanner_unittest, and  built, three test programs called pcrecpp_unittest, pcre_scanner_unittest, and
551  pcre_stringpiece_unittest are also built. When JIT support is enabled, another  pcre_stringpiece_unittest are also built. When JIT support is enabled, another
552  test program called pcre_jit_test is built.  test program called pcre_jit_test is built.
553    
554  Both the scripts and all the program tests are run if you obey "make check" or  Both the scripts and all the program tests are run if you obey "make check" or
# Line 561  testoutput files. Some tests are relevan Line 561  testoutput files. Some tests are relevan
561  were selected. For example, the tests for UTF-8 support are run only if  were selected. For example, the tests for UTF-8 support are run only if
562  --enable-utf8 was used. RunTest outputs a comment when it skips a test.  --enable-utf8 was used. RunTest outputs a comment when it skips a test.
563    
564  Many of the tests that are not skipped are run up to three times. The second  Many of the tests that are not skipped are run up to three times. The second
565  run forces pcre_study() to be called for all patterns except for a few in some  run forces pcre_study() to be called for all patterns except for a few in some
566  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
567  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,
568  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.
569    
570  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
# Line 638  higher. Line 638  higher.
638  The thirteenth test checks a number internals and non-Perl features concerned  The thirteenth test checks a number internals and non-Perl features concerned
639  with Unicode property support.  with Unicode property support.
640    
641  The fourteenth test is run only when JIT support is available, and the  The fourteenth test is run only when JIT support is available, and the
642  fifteenth test is run only when JIT support is not available. They test some  fifteenth test is run only when JIT support is not available. They test some
643  JIT-specific features such as information output from pcretest about JIT  JIT-specific features such as information output from pcretest about JIT
644  compilation.  compilation.
645    
646    
# Line 721  The distribution should contain the foll Line 721  The distribution should contain the foll
721    pcre_get.c              ) sources for the functions in the library,    pcre_get.c              ) sources for the functions in the library,
722    pcre_globals.c          )   and some internal functions that they use    pcre_globals.c          )   and some internal functions that they use
723    pcre_info.c             )    pcre_info.c             )
724    pcre_jit_compile.c      )    pcre_jit_compile.c      )
725    pcre_maketables.c       )    pcre_maketables.c       )
726    pcre_newline.c          )    pcre_newline.c          )
727    pcre_ord2utf8.c         )    pcre_ord2utf8.c         )
# Line 738  The distribution should contain the foll Line 738  The distribution should contain the foll
738    pcre.h.in               template for pcre.h when built by "configure"    pcre.h.in               template for pcre.h when built by "configure"
739    pcreposix.h             header for the external POSIX wrapper API    pcreposix.h             header for the external POSIX wrapper API
740    pcre_internal.h         header for internal use    pcre_internal.h         header for internal use
741    sljit/*                 16 files that make up the JIT compiler    sljit/*                 16 files that make up the JIT compiler
742    ucp.h                   header for Unicode property handling    ucp.h                   header for Unicode property handling
743    
744    config.h.in             template for config.h, which is built by "configure"    config.h.in             template for config.h, which is built by "configure"
# Line 805  The distribution should contain the foll Line 805  The distribution should contain the foll
805    mkinstalldirs           script for making install directories    mkinstalldirs           script for making install directories
806    perltest.pl             Perl test program    perltest.pl             Perl test program
807    pcre-config.in          source of script which retains PCRE information    pcre-config.in          source of script which retains PCRE information
808    pcre_jit_test.c         test program for the JIT compiler    pcre_jit_test.c         test program for the JIT compiler
809    pcrecpp_unittest.cc          )    pcrecpp_unittest.cc          )
810    pcre_scanner_unittest.cc     ) test programs for the C++ wrapper    pcre_scanner_unittest.cc     ) test programs for the C++ wrapper
811    pcre_stringpiece_unittest.cc )    pcre_stringpiece_unittest.cc )

Legend:
Removed from v.685  
changed lines
  Added in v.691

  ViewVC Help
Powered by ViewVC 1.1.5