|
From: | Jacob Bachmeyer |
Subject: | bug#44703: Inadequate documentation of dejagnu.exp |
Date: | Tue, 17 Nov 2020 21:57:47 -0600 |
User-agent: | Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.8.1.22) Gecko/20090807 MultiZilla/1.8.3.4e SeaMonkey/1.1.17 Mnenhy/0.7.6.0 |
Robert Menteer via Bug-dejagnu via wrote:
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.
When referring to the manual, please include the titles of the sections; the section numbering has recently changed and will continue to change as the manual is reorganized.
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.
In current Git master (soon to be a 1.6.3-rc), there is a chapter 6 "Unit Testing" and additional improvements to the existing unit test support in dejagnu.h are a notable item currently planned for 1.6.4.
load_lib dejagnu.exp host_execute $srcdir/unit-code/t_opts
I believe that the current manual adequately explains this, but I will add a note to my TODO list for the ongoing larger manual restructuring.
Closing report as already fixed; not in current master. -- Jacob
[Prev in Thread] | Current Thread | [Next in Thread] |