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

Diff of /code/trunk/README

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

revision 338 by ph10, Sun Apr 13 14:58:34 2008 UTC revision 391 by ph10, Tue Mar 17 21:16:01 2009 UTC
# Line 1  Line 1 
1  README file for PCRE (Perl-compatible regular expression library)  README file for PCRE (Perl-compatible regular expression library)
2  -----------------------------------------------------------------  -----------------------------------------------------------------
3    
4  The latest release of PCRE is always available from  The latest release of PCRE is always available in three alternative formats
5    from:
6    
7    ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-xxx.tar.gz    ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-xxx.tar.gz
8      ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-xxx.tar.bz2
9      ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-xxx.zip
10    
11  There is a mailing list for discussion about the development of PCRE at  There is a mailing list for discussion about the development of PCRE at
12    
# Line 158  library. You can read more about them in Line 161  library. You can read more about them in
161    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,
162    it will try to build the C++ wrapper.    it will try to build the C++ wrapper.
163    
164  . If you want to make use of the support for UTF-8 character strings in PCRE,  . If you want to make use of the support for UTF-8 Unicode character strings in
165    you must add --enable-utf8 to the "configure" command. Without it, the code    PCRE, you must add --enable-utf8 to the "configure" command. Without it, the
166    for handling UTF-8 is not included in the library. (Even when included, it    code for handling UTF-8 is not included in the library. Even when included,
167    still has to be enabled by an option at run time.)    it still has to be enabled by an option at run time. When PCRE is compiled
168      with this option, its input can only either be ASCII or UTF-8, even when
169      running on EBCDIC platforms. It is not possible to use both --enable-utf8 and
170      --enable-ebcdic at the same time.
171    
172  . If, in addition to support for UTF-8 character strings, you want to include  . If, in addition to support for UTF-8 character strings, you want to include
173    support for the \P, \p, and \X sequences that recognize Unicode character    support for the \P, \p, and \X sequences that recognize Unicode character
# Line 252  library. You can read more about them in Line 258  library. You can read more about them in
258    pcre_chartables.c.dist. See "Character tables" below for further information.    pcre_chartables.c.dist. See "Character tables" below for further information.
259    
260  . It is possible to compile PCRE for use on systems that use EBCDIC as their  . It is possible to compile PCRE for use on systems that use EBCDIC as their
261    default character code (as opposed to ASCII) by specifying    character code (as opposed to ASCII) by specifying
262    
263    --enable-ebcdic    --enable-ebcdic
264    
265    This automatically implies --enable-rebuild-chartables (see above).    This automatically implies --enable-rebuild-chartables (see above). However,
266      when PCRE is built this way, it always operates in EBCDIC. It cannot support
267      both EBCDIC and UTF-8.
268    
269  . It is possible to compile pcregrep to use libz and/or libbz2, in order to  . It is possible to compile pcregrep to use libz and/or libbz2, in order to
270    read .gz and .bz2 files (respectively), by specifying one or both of    read .gz and .bz2 files (respectively), by specifying one or both of
# Line 275  library. You can read more about them in Line 283  library. You can read more about them in
283    the readline() function. This provides line-editing and history facilities.    the readline() function. This provides line-editing and history facilities.
284    Note that libreadline is GPL-licenced, so if you distribute a binary of    Note that libreadline is GPL-licenced, so if you distribute a binary of
285    pcretest linked in this way, there may be licensing issues.    pcretest linked in this way, there may be licensing issues.
286    
287    Setting this option causes the -lreadline option to be added to the pcretest    Setting this option causes the -lreadline option to be added to the pcretest
288    build. In many operating environments with a sytem-installed readline    build. In many operating environments with a sytem-installed readline
289    library this is sufficient. However, in some environments (e.g. if an    library this is sufficient. However, in some environments (e.g. if an
290    unmodified distribution version of readline is in use), it may be necessary    unmodified distribution version of readline is in use), it may be necessary
291    to specify something like LIBS="-lncurses" as well. This is because, to quote    to specify something like LIBS="-lncurses" as well. This is because, to quote
292    the readline INSTALL, "Readline uses the termcap functions, but does not link    the readline INSTALL, "Readline uses the termcap functions, but does not link
293    with the termcap or curses library itself, allowing applications which link    with the termcap or curses library itself, allowing applications which link
294    with readline the to choose an appropriate library."    with readline the to choose an appropriate library." If you get error
295      messages about missing functions tgetstr, tgetent, tputs, tgetflag, or tgoto,
296      this is the problem, and linking with the ncurses library should fix it.
297    
298  The "configure" script builds the following files for the basic C library:  The "configure" script builds the following files for the basic C library:
299    
# Line 640  The distribution should contain the foll Line 650  The distribution should contain the foll
650    pcre_study.c            )    pcre_study.c            )
651    pcre_tables.c           )    pcre_tables.c           )
652    pcre_try_flipped.c      )    pcre_try_flipped.c      )
653    pcre_ucp_searchfuncs.c  )    pcre_ucd.c              )
654    pcre_valid_utf8.c       )    pcre_valid_utf8.c       )
655    pcre_version.c          )    pcre_version.c          )
656    pcre_xclass.c           )    pcre_xclass.c           )
# Line 649  The distribution should contain the foll Line 659  The distribution should contain the foll
659    pcre.h.in               template for pcre.h when built by "configure"    pcre.h.in               template for pcre.h when built by "configure"
660    pcreposix.h             header for the external POSIX wrapper API    pcreposix.h             header for the external POSIX wrapper API
661    pcre_internal.h         header for internal use    pcre_internal.h         header for internal use
662    ucp.h                   ) headers concerned with    ucp.h                   header for Unicode property handling
   ucpinternal.h           )   Unicode property handling  
   ucptable.h              ) (this one is the data table)  
663    
664    config.h.in             template for config.h, which is built by "configure"    config.h.in             template for config.h, which is built by "configure"
665    
# Line 725  The distribution should contain the foll Line 733  The distribution should contain the foll
733    
734  (D) Auxiliary files for cmake support  (D) Auxiliary files for cmake support
735    
736      cmake/COPYING-CMAKE-SCRIPTS
737      cmake/FindPackageHandleStandardArgs.cmake
738      cmake/FindReadline.cmake
739    CMakeLists.txt    CMakeLists.txt
740    config-cmake.h.in    config-cmake.h.in
741    
# Line 749  The distribution should contain the foll Line 760  The distribution should contain the foll
760  Philip Hazel  Philip Hazel
761  Email local part: ph10  Email local part: ph10
762  Email domain: cam.ac.uk  Email domain: cam.ac.uk
763  Last updated: 13 April 2008  Last updated: 17 March 2009

Legend:
Removed from v.338  
changed lines
  Added in v.391

  ViewVC Help
Powered by ViewVC 1.1.5