/[pcre]/code/trunk/README

Diff of /code/trunk/README

Parent Directory | Revision Log | View Patch Patch

-revision 260 by ph10,
Thu Sep 20 10:19:16 2007 UTC
+revision 345 by ph10,
Mon Apr 28 15:10:02 2008 UTC
 Line 119 
 If you are using HP's ANSI C++ compiler
  in the section entitled "Using HP's ANSI C++ compiler (aCC)" below.
  The following instructions assume the use of the widely used "configure, make,
- make install" process. There is also some experimental support for "cmake" in
+ make install" process. There is also support for CMake in the PCRE
- the PCRE distribution, but it is incomplete and not documented. However, if you
+ distribution; there are some comments about using CMake in the NON-UNIX-USE
- are a "cmake" user, you might want to try it.
+ file, though it can also be used in Unix-like systems.
  To build PCRE on a Unix-like system, first run the "configure" command from the
  PCRE distribution directory, with your current directory set to the directory
 Line 258 
 library. You can read more about them in
    This automatically implies --enable-rebuild-chartables (see above).
+ . It is possible to compile pcregrep to use libz and/or libbz2, in order to
+   read .gz and .bz2 files (respectively), by specifying one or both of
+   --enable-pcregrep-libz
+   --enable-pcregrep-libbz2
+   Of course, the relevant libraries must be installed on your system.
+ . It is possible to compile pcretest so that it links with the libreadline
+   library, by specifying
+   --enable-pcretest-libreadline
+   If this is done, when pcretest's input is from a terminal, it reads it using
+   the readline() function. This provides line-editing and history facilities.
+   Note that libreadline is GPL-licenced, so if you distribute a binary of
+   pcretest linked in this way, there may be licensing issues.
+   Setting this option causes the -lreadline option to be added to the pcretest
+   build. In many operating environments with a sytem-installed readline
+   library this is sufficient. However, in some environments (e.g. if an
+   unmodified distribution version of readline is in use), it may be necessary
+   to specify something like LIBS="-lncurses" as well. This is because, to quote
+   the readline INSTALL, "Readline uses the termcap functions, but does not link
+   with the termcap or curses library itself, allowing applications which link
+   with readline the to choose an appropriate library."
  The "configure" script builds the following files for the basic C library:
  . Makefile is the makefile that builds the library
-Line 285 
 script that can be run to recreate the c
+Line 312 
 script that can be run to recreate the c
  contains compiler output from tests that "configure" runs.
  Once "configure" has run, you can run "make". It builds two libraries, called
- libpcre and libpcreposix, a test program called pcretest, a demonstration
+ libpcre and libpcreposix, a test program called pcretest, and the pcregrep
- program called pcredemo, and the pcregrep command. If a C++ compiler was found
+ command. If a C++ compiler was found on your system, "make" also builds the C++
- on your system, "make" also builds the C++ wrapper library, which is called
+ wrapper library, which is called libpcrecpp, and some test programs called
- libpcrecpp, and some test programs called pcrecpp_unittest,
+ pcrecpp_unittest, pcre_scanner_unittest, and pcre_stringpiece_unittest.
- pcre_scanner_unittest, and pcre_stringpiece_unittest. Building the C++ wrapper
+ Building the C++ wrapper can be disabled by adding --disable-cpp to the
- can be disabled by adding --disable-cpp to the "configure" command.
+ "configure" command.
  The command "make check" runs all the appropriate tests. Details of the PCRE
  tests are given below in a separate section of this document.
-Line 342 
 system. The following are installed (fil
+Line 369 
 system. The following are installed (fil
      pcretest.txt   the pcretest man page
      pcregrep.txt   the pcregrep man page
- Note that the pcredemo program that is built by "configure" is *not* installed
- anywhere. It is a demonstration for programmers wanting to use PCRE.
  If you want to remove PCRE from your system, you can run "make uninstall".
  This removes all the files that "make install" installed. However, it does not
  remove any directories, because these are often shared with other programs.
-Line 725 
 The distribution should contain the foll
+Line 749 
 The distribution should contain the foll
  Philip Hazel
  Email local part: ph10
  Email domain: cam.ac.uk
- Last updated: 21 September 2007
+ Last updated: 13 April 2008

 Legend:



Removed from v.260
 


changed lines


 
Added in v.345
 Legend:



Removed from v.260
 


changed lines


 
Added in v.345
-Removed from v.260
+Added in v.345

webmaster@exim.org	ViewVC Help
Powered by ViewVC 1.1.12