The Borges Test Suite
----------------------
You will find the Borges Test Suite under the utils/test dir of your
Borges repository. It is composed of a test script and a few needed
files.

All tests are fully automated, so all you have to do is to run the
testBorges.sh script and wait until it finishes running.


Testing Procedure
------------------
To use the test suite you will need to:

   0) install package "cvs"

   1) Create a directory where tests are going to be performed.

   2) Copy the contents of utils/test to that directory (you can omit
      the .fig image explaining the test's steps).

   3) Edit testBorges.sh and change the location of your Borges
      installation directory in the DMSDIR variable, if it is
      different than the default one (/usr/share/Borges).

   4) Change to the directory created in step 1) and run
      ./testBorges.sh.

As an option for step 4), you can run the script with:

./testBorges.sh 1>log.txt 2>&1

which will put all output messages in the log.txt file instead of the
console. This is handy for debugging purposes, and is the recommended
way of running the tests.

Once the tests finish, you can browse the reports generated at
different test stages (please refer to the accompanying .fig image to
see which steps are performed to generate reports) under the
Reports/R* directories.


In The Future
--------------

	* More automation will be added by making the test script
          compare reports generated with known-to-be-good ones and
          reporting at the end of the test, the tests that went OK and
          the ones that FAILED.

	* More test steps will be added.



