GNU bug report logs - #67391
dejagnu report card and multiple rows

Previous Next

Package: dejagnu;

Reported by: Tom Tromey <tom <at> tromey.com>

Date: Wed, 22 Nov 2023 23:53:01 UTC

Severity: normal

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

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 67391 in the body.
You can then email your comments to 67391 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-dejagnu <at> gnu.org:
bug#67391; Package dejagnu. (Wed, 22 Nov 2023 23:53:01 GMT) Full text and rfc822 format available.

Acknowledgement sent to Tom Tromey <tom <at> tromey.com>:
New bug report received and forwarded. Copy sent to bug-dejagnu <at> gnu.org. (Wed, 22 Nov 2023 23:53:01 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Tom Tromey <tom <at> tromey.com>
To: bug-dejagnu <at> gnu.org
Subject: dejagnu report card and multiple rows
Date: Wed, 22 Nov 2023 16:52:48 -0700
I tried "dejagnu report card" today for gdb (well, the subset of gdb
tests that I most recently ran).  It shows:

prentzel. dejagnu report card gdb.sum
      __________________________________________________
     /    PASS   FAIL  ?PASS  ?FAIL  UNSUP  UNRES UNTEST
     |--------------------------------------------------
gdb  |    8599      0      0     37      0      0      0
     |--------------------------------------------------
     |    8599      0      0     37      0      0      0
     \__________________________________________________


I couldn't figure out why there would be two rows here.
The documentation doesn't describe it either.

Is the second row the sum?  If so (1) if there's a single tool, maybe it
can be omitted; and (2) perhaps this could be mentioned in the
documentation, maybe with some example output.

thanks,
Tom




Information forwarded to bug-dejagnu <at> gnu.org:
bug#67391; Package dejagnu. (Thu, 23 Nov 2023 02:42:01 GMT) Full text and rfc822 format available.

Message #8 received at 67391 <at> debbugs.gnu.org (full text, mbox):

From: Jacob Bachmeyer <jcb62281 <at> gmail.com>
To: Tom Tromey <tom <at> tromey.com>
Cc: 67391 <at> debbugs.gnu.org
Subject: Re: bug#67391: dejagnu report card and multiple rows
Date: Wed, 22 Nov 2023 20:41:40 -0600
Tom Tromey wrote:
> I tried "dejagnu report card" today for gdb (well, the subset of gdb
> tests that I most recently ran).  It shows:
>
> prentzel. dejagnu report card gdb.sum
>       __________________________________________________
>      /    PASS   FAIL  ?PASS  ?FAIL  UNSUP  UNRES UNTEST
>      |--------------------------------------------------
> gdb  |    8599      0      0     37      0      0      0
>      |--------------------------------------------------
>      |    8599      0      0     37      0      0      0
>      \__________________________________________________
>
>
> I couldn't figure out why there would be two rows here.
> The documentation doesn't describe it either.
>
> Is the second row the sum?

Correct.  If multiple passes were tested there is an additional group of 
per-pass total lines before the grand total at the end.  The grand total 
is always produced and was expected to be self-documenting, as 
recognizing it as the sum of the tool lines was expected to be obvious.  
It turns out to be a bit less obvious when there is only one tool...

>   If so (1) if there's a single tool, maybe it
> can be omitted; and (2) perhaps this could be mentioned in the
> documentation, maybe with some example output.
>   

There are examples in the dejagnu-report-card(1) manpage.  The "dejagnu 
help report card" command should display it.  I seem to recall omitting 
them from the Texinfo manual for reasons of style, but manpages 
traditionally have an EXAMPLES section, so there they are.

Given that the pass totals are already omitted if not relevant, omitting 
the grand totals if only one row was emitted is a future possibility.

The original use case for "dejagnu report card" was to collect results 
from testing multiple tools in a convenient summary display.  If you are 
only testing one tool, DejaGnu itself produces a similar summary, 
although not quite as compact.

In any case, a documentation patch has been pushed on the PR67391 
branch.  Does it resolve the confusion?


-- Jacob




Reply sent to jcb62281 <at> gmail.com:
You have taken responsibility. (Wed, 13 Dec 2023 02:41:02 GMT) Full text and rfc822 format available.

Notification sent to Tom Tromey <tom <at> tromey.com>:
bug acknowledged by developer. (Wed, 13 Dec 2023 02:41:02 GMT) Full text and rfc822 format available.

Message #13 received at 67391-done <at> debbugs.gnu.org (full text, mbox):

From: Jacob Bachmeyer <jcb62281 <at> gmail.com>
To: Tom Tromey <tom <at> tromey.com>
Cc: 67391-done <at> debbugs.gnu.org
Subject: Re: bug#67391: dejagnu report card and multiple rows
Date: Tue, 12 Dec 2023 20:40:20 -0600
The documentation patch on the PR67391 branch has been merged to master, 
explaining the totals line at the end of "dejagnu report card" output.  
Closing issue.


-- Jacob




bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Wed, 10 Jan 2024 12:24:09 GMT) Full text and rfc822 format available.

This bug report was last modified 1 year and 147 days ago.

Previous Next


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