This archive contains the following:

  * A RISC OS port of PCRE (Perl Compatible Regular Expressions)
  * regex, a simple command line tool to demonstrate the former

-----

PCRE is a linkable C library, and it is recommended that you copy it to the
same directory as other C libraries on your system. Assuming a fairly normal
setup, this can be achieved with a command like:

*copy pcrelib ADFS::4.$.AcornC/C++.Export.APCS-32.Lib R

Once installed in this way, set a path to the library's location, eg:

*set PCRE$Path ADFS::4.$.AcornC/C++.Export.APCS-32.Lib.pcrelib.

Then you can compile and link your code with PCRE. The regex utility gives a
simple example of this. For more documentation on PCRE, please see:

http://www.pcre.org/original/docs/html

PCRE is made available under a BSD licence. For more information, please see
the file pcrelib.Licence in this archive.

-----

regex is a simple command line tool to demonstrate the use of PCRE. It
allows you to specify a regular expression, and then tries to match that
against consecutive lines of text in a specified file. It can be built from
the included source with the ROOL development tools if you have them. First
ensure that the usual paths have been set for the C compiler and libraries,
then set the path to PCRE as described above. Now change to the regex
directory and type *amu to build regex.

Some documentation for regex can be found in the file regex.Readme in this
present archive.
 
regex is intended as an example of using the PCRE library; it is NOT
production quality code! Please feel free to look at the source, or to
modify it for your own use, but do not further distribute it as is.
