bug#44703: closed (Inadequate documentation of dejagnu.exp)

[GNU bug Tracking System]

Your message dated Tue, 17 Nov 2020 21:57:47 -0600
with message-id <5FB49BBB.9040300@gmail.com>
and subject line Re: bug#44703: Inadequate documentation of dejagnu.exp
has caused the debbugs.gnu.org bug report #44703,
regarding Inadequate documentation of dejagnu.exp
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs@gnu.org.)


-- 
44703: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=44703
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems

--- Begin Message --- Subject: Inadequate documentation of dejagnu.exp Date: Tue, 17 Nov 2020 08:53:08 -0500

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

--- End Message ---

> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: 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
>
>
>
> --- End Message ---