This test tree now contains a framework for regression testing based on
DejaGnu-1.3, available from your favorite GNU mirror.

In order to use of these tests as regression tests, first read the README
file in the Xm/Xlab directory.  We need to get xlab recordings of all the
tests linked against Motif.  In order to create a set of xlab recordings
for a directory, cd to that directory, and then run ../Xlab/RecordAll.
Once you've got the recordings, check them in if you're on the core team,
or submit them to the list as a tarfile if you're not.

After you've recorded all the xlab tests you want, run CreateTests from
the lesstif/test directory. This script creates an basic DejaGnu script for
each program in the Xm tree, and if there is a xlab recording, CreateTests
also creates an DejaGnu script to use those recordings.

The guts of the expect/dejagnu testing is controled in the file
test/config/unix.exp.  This is an expect script (expect is part of
DejaGnu, and has Tcl syntax).  If you create a new kind of test that will
be useful for more than one program, you should add it here, and probably
not in the individual testXX.exp files.

Now, from any of the test directories, you can run "make check".  This
will invoke DejaGnu and run all the available tests for that directory and
its subdirectories.  The output is placed in the two files LessTif.log and
LessTif.sum in each directory.  Instead of "make check" you can use
"runtest --all" (installed as part of DejaGnu).   The difference between
this and running "make check" is simply that "make check" first builds
executables if need be, and the "--all" option to runtest also makes
DejaGnu report successful tests instead of failures.


