bug#44636: closed (Misleading documentation)

[GNU bug Tracking System]

Your message dated Tue, 17 Nov 2020 21:56:55 -0600
with message-id <5FB49B87.6070502@gmail.com>
and subject line Re: bug#44636: Misleading documentation
has caused the debbugs.gnu.org bug report #44636,
regarding Misleading documentation
to be marked as done.

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


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

--- Begin Message --- Subject: Misleading documentation Date: Sat, 14 Nov 2020 11:14:13 -0500

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

--- End Message ---

> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#44636: Misleading documentation
>
>
>
>
> Date: 
>
> Tue, 17 Nov 2020 21:56:55 -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:
> > 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
>
>
>
> --- End Message ---