=head1 Name

README.Testing Explains structure and use of Testing/

=head1 Purpose

The purpose of Testing directory is to provide test scripts to test the 
correct functionality of the programs provided with this distribution. The 
test scripts can be run to make sure that package is installed properly and 
all required system paths are set. This also helps us to test backward 
compatibility of programs when programs are upgraded. 

=head1 Organization 

Testing/ contains various sub directories, each of which tests 
individual program of this package. 

Each subdirectory has various .sh test files written in C shell script. 
All tests that test behavior of a program under normal conditions are 
named as testA*sh, and all those that test error conditions are named as 
testB*.sh. Note that in earlier versions the testA*.sh scripts were run 
by a script called normal-op.sh, and the testB*.sh scripts were run by a 
script called error-op.sh. However, this required that subtestll.sh and 
testall.sh (the main driver scripts for the Testing directory) be 
installed in the system level binary directory. We'd prefer to keep the 
Testing scripts and data isolated to the Testing directory, so we 
created a single script ot run all test cases, ALL-TESTS.sh

All test scripts in all the program directories can be run with a single 
command 'csh ./TEST-ALL.sh'. If you add or change test cases, this is 
the only place you will need to make modifications to add your test case to 
the sequence of test scripts. 

If everything is fine, the tests will show the following:

 STATUS : OK 

If the package is not installed rightly or paths not set, 
Tests will show the following:

 STATUS : ERROR 

=head1 Authors

Ted Pedersen, University of Minnesota, Duluth
tpederse at d.umn.edu

Amruta Purandare
University of Pittsburgh

Anagha Kulkarni
Carnegie-Mellon University

Mahesh Joshi
Carnegie-Mellon University

=head1 Acknowledgment

This work has been partially supported by a National Science Foundation
Faculty Early CAREER Development award (#0092784).

=head1 Copyright

Copyright 2002-2008, Ted Pedersen, Anagha Kulkarni, Mahesh Joshi, Amruta Purandare

This suite of programs is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place - Suite 330, Boston, MA  02111-1307, USA.

Note: The text of the GNU General Public License is provided in the file
GPL.txt that you should have received with this distribution.

=cut
