src/regex/README

   1 wxWindows regex
   2 ----------------
   3 This is a version of Henry Spencer's regex,
   4 which was taken from postresql, which was
   5 taken from the source of TCL (Toolkit Command Language).
   6
   7 This is version of Henry Spencer's library is
   8 modified by the wxWindows team.  The modifications
   9 made by the wxWindows team are as follows:
  10 regcustom.h (all source code)
  11 regex.h (function wrappers, other)
  12 regc_locale.c (A function or two).
  13 All the rest (Using standard c library routines instead of
  14               postresql routines, various cleanup/optimizations)
  15
  16 The source code that is wxWindows-specific is as follows:
  17 regcustom.h (all source code, see comments in source on how to replace)
  18 regex.h (where noted with comments in source, compiler workarounds)
  19 regcomp.c (a few of the functions prefixed with wx_,
  20            these may be replaced by c library routines)
  21
  22 This newer library was chosen over the old one because
  23 Henry Spencer's old library did not support unicode and
  24 had some other bugs that were fixed by this one, and
  25 the license was incompatible with the wxWindows license
  26 and the gpl.
  27
  28 Regular Expression syntax documentation is in re_syntax.n.
  29 Programming information (from older regex, but with
  30 the function wrappers implemented in the wxWindows
  31 version, the usage is somewhat the same) is in regex.3.
  32
  33 Modifications made by the wxWindows team are not licensed.
  34 Contact - Ryan Norton <wxprojects@comcast.net>
  35
  36 The original readme (from the TCL distribution) follows:
  37
  38 alpha3.8 release.
  39 Tue Aug 10 15:51:48 EDT 1999
  40 henry@spsystems.net  (formerly henry@zoo.toronto.edu)
  41
  42 See WHATSNEW for change listing.
  43
  44 installation notes:
  45 --------
  46 Read the comments at the beginning of Makefile before running.
  47
  48 Utils.h contains some things that just might have to be modified on
  49 some systems, as well as a nested include (ugh) of <assert.h>.
  50
  51 The "fake" directory contains quick-and-dirty fakes for some header
  52 files and routines that old systems may not have.  Note also that
  53 -DUSEBCOPY will make utils.h substitute bcopy() for memmove().
  54
  55 After that, "make r" will build regcomp.o, regexec.o, regfree.o,
  56 and regerror.o (the actual routines), bundle them together into a test
  57 program, and run regression tests on them.  No output is good output.
  58
  59 "make lib" builds just the .o files for the actual routines (when
  60 you're happy with testing and have adjusted CFLAGS for production),
  61 and puts them together into libregex.a.  You can pick up either the
  62 library or *.o ("make lib" makes sure there are no other .o files left
  63 around to confuse things).
  64
  65 Main.c, debug.c, split.c are used for regression testing but are not part
  66 of the RE routines themselves.
  67
  68 Regex.h goes in /usr/include.  All other .h files are internal only.
  69 --------