This directory contains the following files:

    - CONTENTS
        : this file

    - README
        : read carefully before doing experiment

    - install.sh

    - install_seeded.sh


1. install.sh : copy application, a specific version of component 
                files, and test drivers to the source directory and 
                compile them.
		This script file is for checking out files from orig 
                or inst directory 

   Usage: 
   %install.sh version_option  component-version 

   The version_option can be orig, inst/comp-level, inst/method-level, 
   inst/stmt-level or inst/coverage.

   The component_version can be 0 through 7 

   Example 1:
   %install.sh inst/stmt-level 0 

   Then, install.sh copies application files, statement-level instrumented 
   component version 0 and test drivers to the source directory and compile 
   them.

   Example 2:
   %install.sh orig 3

   Then, checkout copies application files, original component version 3 and
   test drivers to the source directory and compile them.

2. install_seeded.sh : copy application, a specific faulty version of component 
                      files, and test drivers to the source directory and 
                      compile them.
		      This script file is for checking out files from seeded 
                      directory and is used in the fault matrix script. 
 
   Usage: 
   %install_seeded.sh seeded component-version

   This script should be used when you generate fault matrix using 
   j-tools-package.

3. testrun : run test cases and save outputs into output directory.
             This script is used in running instrumented versions of
             Siena (inst/comp-level, inst/method-level, inst/stmt-level)

   Usage: 
   %testrun file_name

   The file_name saves selected tests. 

   Example:
   %testrun method_10

   Then, testrun executes test cases in the testplans and 
   saves selected tests to method_10.

NOTE: To run test cases for original or faulty version, you should generate
      test script file using javamts.
      The universe file is in the testplans.alt directory.
      To generate test script from universe file, you should have javamts 
      which generates Bourne shell scripts.
      You should give proper classpath name in the universe file.
