The following is the interface the individual tests are supposed to
provide.  Let the name of the test be TEST, then in a directory named
TEST there needs to be available

 - a script named TEST.sh which gets passed
    * BASEDIR        - the full path of the TEST directory
    * GCCINSTALLDIR  - the install path of the compiler to use, this is
		       the $prefix part of $prefix/bin/gcc
    * LOGDIR         - the directory to place logfiles
    * TMPDIR         - a directory that can be used to place temporary files,
		       this will be preserved and all compiling and running
		       will take place here, so you can debug inside this if
		       anything goes wrong
   it is expected that the script places a file named TEST-performance-latest
   in the LOGDIR in addition to the individual logfiles.

 - a script named TEST-summary.sh which gets passed BASEDIR, LOGDIR and
   TMPDIR.  This script is supposed to create summary data from the
   logfiles into TMPDIR, especially a file named TEST-summary.txt
   which should contain raw data that is used to produce the plots.
   Generated files such as .png files and the above summary.txt will
   be moved to the HTMLTARGETDIR, if specified.


The gen-gp.sh script can be used to generate gnuplot scripts that are
used to produce the graphs out of the TEST-summary.txt data.  See the
top of this script for documentation on how to use it.  Convenient
re-generation of the various .gp files is possible by concatenating
the header.gp file from the TEST directory (or the toplevel one, if
there is no TEST specific one) and re-executing the commands you get
out of the existing .gp file grepping for gen-gp, concatenating the
output of them to the new file.


Producing baselines with Intel ICC:

 - set up a directory with bin, lib, lib64, the latter linked from the 
   ICC installation
 - put gcc and g++ scripts in bin which wrap to icpc/icc $@ with possibly
   specifying -cxxlib-icc and/or -gcc-binary=X to specify the libstdc++
   to use (-cxxlib-icc only on ia32)
 - use -w if you want not to be flooded with icc output
 - remember to unset PATH in the wrappers
 - use exec to execute icc
 - remember to source the ICC iccvars.sh before producing the baseline

