REXML is an XML parser for Ruby, in Ruby.
URL: http://www.germane-software.com/~ser/software/rexml
Author: Sean Russell <ser@germane-software.com>


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

These are the benchmark programs.  You're probably only interested in the first
one.

   comparison.rb        Runs a suite of benchmarks, writing the output to
                        index.html as a table of comparisons.  The base is
                        REXML; all other toolkits have values proportional to
                        the times of REXML.  Values are in "calls per second",
                        followed by a paranthetical value which is how fast
                        it is compared to REXML.  Higher values are better.
                        If you have any of the following installed, tests
                        will be run for:
                        REXML, NQXML, XMLParser, and Electric XML (Java)
                        Any of these that you don't have installed (except
                        REXML) will be ignored.
   profile.rb           A profiling suite, using Ruby's profile module
   bench.rb             Runs an REXML benchmark suite, testing the times of
                        various operations.  This uses the PickAxe benchmark
                        module.
   nqxml_bench.rb       The same operations, using NQXML (you must, of course,
                        have NQXML installed to run this).  This is just for
                        comparison purposes.
   flatbench.rb         The same operations (using REXML) using CPS
   nqxml_flatbench.rb   The same operations (using NQXML) using CPS
   flatbench.java       The Java source for the same operations, using a Java
                        version of the CPS.  You must have EXML.jar (from
                        the Electric XML distribution) to compile and run
                        this.
   cps.rb               My benchmarking class.  It stands for Calls Per
                        Second.  I like fixed-time benchmarks.  Rather
                        than calling a method X times and seeing how long it
                        took, CPS sees how many times it can call a proc
                        within a given time.
   *.xml                Source files used by various benchmark classes

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

   ruby -I.. flatbench.rb

Please see the documentation for more information.

--- SER
*2001-295
