GNU bug report logs - #44636
Misleading documentation

Previous Next

Package: dejagnu;

Reported by: Robert Menteer <reetnem <at> mac.com>

Date: Sat, 14 Nov 2020 16:15:01 UTC

Severity: normal

Done: Jacob Bachmeyer <jcb62281 <at> gmail.com>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Robert Menteer <reetnem <at> mac.com>
Subject: bug#44636: closed (Re: bug#44636: Misleading documentation)
Date: Wed, 18 Nov 2020 03:58:02 +0000
[Message part 1 (text/plain, inline)]
Your bug report

#44636: Misleading documentation

which was filed against the dejagnu package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 44636 <at> debbugs.gnu.org.

-- 
44636: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=44636
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Jacob Bachmeyer <jcb62281 <at> gmail.com>
To: Robert Menteer <reetnem <at> mac.com>, 
 Robert Menteer via Bug-dejagnu <bug-dejagnu <at> gnu.org>
Cc: 44636-done <at> debbugs.gnu.org
Subject: Re: bug#44636: Misleading documentation
Date: Tue, 17 Nov 2020 21:56:55 -0600
Robert Menteer via Bug-dejagnu via wrote:
> In section 4.2.2 of the info manual for DejaGnu it suggests to create 
> a subdirectory config then create a tool init file in it. If I copy 
> the unix.exp example to /…/testsuite/config/tool.exp runtool does not 
> appear to read it.

You are correct that this is wrong; the manual is conflating tool init 
files and target interface files here.

> Looking around the web I found a mention of placing the init file in 
> /…/testsuite/lib/.

This is correct; the manual has been corrected in commit 
9950000f4ec0f6cd2c5afbc8ec5413391c20a535.

Closing as now fixed.


-- Jacob


[Message part 3 (message/rfc822, inline)]
From: Robert Menteer <reetnem <at> mac.com>
To: Robert Menteer via Bug-dejagnu <bug-dejagnu <at> gnu.org>
Subject: Misleading documentation
Date: Sat, 14 Nov 2020 11:14:13 -0500
[Message part 4 (text/plain, inline)]
In section 4.2.2 of the info manual for DejaGnu it suggests to create a subdirectory config then create a tool init file in it. If I copy the unix.exp example to /…/testsuite/config/tool.exp runtool does not appear to read it. Looking around the web I found a mention of placing the init file in /…/testsuite/lib/. This does seem to work as I get the following output:

Using ./lib/FlDist.exp as tool init file.

Another problem with the example init file in that same section is the expect statement:

global ${examplename}

This causes the following error:

ERROR: tcl error sourcing tool init file ./lib/FlDist.exp.
can't read "examplename": no such variable

The problem with the documentation is not that it uses examplename in it’s example but there is nothing explaining how to modify examplename to fit the tool. This is in contrast to naming files which is explained in the manual.

Thanks,
Bob Menteer
[Message part 5 (text/html, inline)]

This bug report was last modified 4 years and 237 days ago.

Previous Next


GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.