###############################################################################
#                                    Files                                    #
###############################################################################

There are some files you can run or look at just to get started:

   install.rb           Run this to install REXML
   suite.rb             A unit test suite.  You must have runit (or
                        test/unit) installed to run this.  If you want 
                        to run it before you install REXML, use 
                        "ruby -I. suite.rb".
   repackage.rb         This script builds a distribution that you can
	                      include with your applications.  It contains a
                        directory with the REXML files, a short README,
                        and the REXML licenses.  This is the minimum
                        REXML redistribution package.
	 upgrade.rb           This is not for you.  Ignore this file.  All this
                        script does is change the versions and dates in 
                        several files in the distribution.
   Oasis.rb             A script to run XML parsers against the Oasis test
                        suite.  Read the top of the file for more information
                        about running the script; at the very least, you have
                        to tell the script where the Oasis tests are.

If you have ruby in your path, you should be able to execute any of the
.rb files, although some of them may not run if you don't have certain
packages installed.  Run these from the main REXML directory; IE, call
them like "bin/install.rb" or "ruby bin/repackage.rb".

If you want to run these programs without installing REXML, you must make
sure that REXML is in your include path.  For example:

   ruby -I. bin/suite.rb

If you want to include REXML in your application, run repackage.rb and
include the resulting rexml_dist directory in your distribution.  Make
sure that your distribution either installs REXML, or that your application
includes the rexml_dist directory in the Ruby include path.

--- SER
