bug#44703: Inadequate documentation of dejagnu.exp

[Robert Menteer]

Section 5.1 implies each unit test is batch process. Section 5.2 states that dejagnu.exp can be used for testing the batch processes for unit testing. Section 4.6 says to look examine the GNU GCC testsuite for how to write test for batch processes.

The section on using dejagnu.exp states little TCL is needed but the GNU GCC tests have thousands of lines of TCL. It took me many days before I finally did «find / -name dejagnu.exp» and looked to see how to write an xxx.exp file for a unit test.

Please document how to use the procedures in dejagnu.exp and supply a minimal unit test xxx.exp file like the one below.

load_lib dejagnu.exp

host_execute $srcdir/unit-code/t_opts

At a bare minimum tell people to read dejagnu.exp

Thanks,

Bob Menteer