Script files for GraphSPL object
bad-mutant-vers     - a file containing the faulted versions that are invalid/non-functional
                      (e.g. won't build due to syntax error caused by fault inserted)
install_faulted.sh  - installs and builds a faulted version using AHEAD tool suite
install.sh          - installs and builds an unfaulted version/variant of GraphSPL
mkFaulted.sh        - builds all versions with all faults using AHEAD tool suite
mkFaultMatrix.sh    - makes fault matrices using AHEAD tool suite to build
run-CompareTests.sh - runs tests with compare steps needed for fault matrix construction
run-OrigTests.sh    - runs the original test suite
run-Tests.sh        - runs the original test suite
singleTestRun.sh    - runs a single test on the object
bad-mutants.txt     - a list of all the version/fault combinations that would not
                      build because the fault was not syntactically valid
                      due to the fault being bad/invalid
line-equalized.txt  - a list of the faulted variants manually modified to
                      remove non-deterministic output (line # difference in
                      expected exception trace output)
README              - this file


The GraphSPL object has been packaged to allow performing tests with and without
the AHEAD tool suite.  To perform testing on this artifact without AHEAD:
    1. Use the install.sh script with the -c flag to copy in the un-faulted,
    pre-built version/variant (1 to 38) of the GraphSPL object.
    2. Execute the run-OrigTests.sh script to generate test outputs
    3. Copy the test output to another location (outputs.alt typically) to be
       used for the compare step (this is your test oracle)
    4. Execute the install_faulted.sh with the -c flag to copy in the faulted
       pre-built version/variant with the specified fault (1 to 60)
    5. Execute the run-OrigTests.sh (or run-CompareTests.sh script if building
       a fault matrix)
    6. Compare outputs in the outputs directory with the saved (oracle) test
       results from step 3 above.
    7. Repeat steps 4 through 6 for each fault.
    8. Repeat steps 1 through 7 for each version/variant

If you have the AHEAD tool suite you can omit the -c flags in the above steps
and build the variants with each test.
****NOTE****
The fault-matrix provided by the SIR in the info directory was generated using
the faulted copies after these copies were line equalized to remove
non-determinism due to line number differences between the original and faulted
versions.  The faulted versions are noted the line-equalized.txt file
as well as each with a versions.alt/faulted/vN.F/instanceGPL/README file
indicating this process has been applied.  Those faulted pre-built versions
that did not require equalization will not have a README file.

If you attempt to reproduce the fault matrix you should apply the line
equalization modifications to your faulted version copy and rebuild using
javac after removing the class files in the instanceGPL directory.  Note: after
applying the line number equalization do not run jak2java as it will overwrite
your equalization modification, only use javac to recompile.  Once rebuilt
rerun the mkFaultMatrix.sh with the -c flag to use the modified version.

