Please read the license agreement in the file License.html before
using the package.  The terms are essentially that you can use the
product without fee to write new software, but you can't distribute
TextTools(TM) as an independent software unit without first negotiating
a licensing agreement with ORO, Inc.  In other words, you can't bundle
TextTools(TM) with a set of development tools.  Please read the license 
agreement for the exact details.

This is the 1.1 version of TextTools(TM), a Java package built
using the OROMatcher(TM) regular expression package.  TextTools(TM)
provides generalized pattern caching classes compatible with both
OROMatcher(TM) and AwkTools(TM) which allow you to manage regular
expressions in your Java programs more effectively.  TextTools(TM)
also provides a powerful MatchActionProcessor class that implements
AWK-like pattern action line-by-line processing of input, making it
very easy to implement the most commonly needed text processing tasks.
TextTools(TM) is completely compatible with OROMatcher(TM) Perl5
regular expression classes as well as AwkTools(TM) regular expression
classes, giving you freedom to choose the regular expression syntax
you use.

The TextTools(TM) pattern caching classes can be used with JDK 1.0.2
and up, but the MatchAction classes require JDK 1.1 and higher for
inner class support.

TextTools(TM) requires the OROMatcher(TM) package which you can download
from http://www.oroinc.com/downloads/.

The distribution consists of the following directories:

o doc/      - A placeholder for a future user's guide.
o doc/api   - javadoc generated API documentation.
o com/      - The TextTools(TM) class files (in com/oroinc/text/)
o examples/ - Example programs 

All files in the archive containing this README file except for the javadoc
images (which are Copyright Sun Microsystems) are Copyright 1997
by ORO, Inc.  All rights reserved.

To use the package, install OROMatcher and then either move the com/
directory to a place of your liking and add it to your CLASSPATH or add the
TextTools classes to the com/oroinc/text/ directory where you have OROMatcher
installed.

Send all bug reports to bugs@oroinc.com.
Send all questions about how to use TextTools(TM) to
support@oroinc.com.
Send all suggestions you may have about what you'd like to see in future
releases to suggestions@oroinc.com.

You can get the latest information about TextTools(TM) and other
ORO products from the ORO, Inc. web site at http://www.oroinc.com/
