GNU bug report logs - #41829
ERT commands that aren't in the info

Previous Next

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

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

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

From: Douglas Lewan <d.lewan2000 <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: ERT commands that aren't in the info
Date: Fri, 12 Jun 2020 12:19:45 -0400

The following ERT commands do not appear in the info doumentation for 
ERT and should.

Most would be appropriate in the section "Running test interactively". 
Those commands with associated keys are mentioned in ert-results-mode, 
but, still, should appear in the info.
The command M-x ert-delete-all-tests is especially useful for creating a 
clean slate, but it is not mentioned at all.

ert-delete-all-tests
ert-delete-test (key D)
ert-describe-test
ert-find-test-other-window
ert-results-describe-test-at-point (key h)
ert-results-jump-between-summary-and-result (key j)
ert-results-next-test (key n)
ert-results-pop-to-timings (key T)
ert-results-previous-test (key p)
ert-results-rerun-all-tests (key R)
ert-run-tests-interactively

It would also be worth mentioning these commands defined elsewhere but 
with an interactive UI in ert-results-mode

describe-mode (key ?)
revert-buffer (key g)
quit-window (key q)

I've verified this looking through the texinfo source for versions 24.5 
and 26.3.

I'd be happy to work on text for this if that's appropriate.

-- 
,Doug
d.lewan2000 <at> gmail.com
(908) 720 7908

If this is what winning looks like, I'd hate to see what losing is.

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Douglas Lewan <d.lewan2000 <at> gmail.com>
Cc: 41829 <at> debbugs.gnu.org
Subject: Re: bug#41829: ERT commands that aren't in the info
Date: Thu, 13 Aug 2020 13:22:44 -0700

Hi Douglas,

Sorry for the late reply here.

Douglas Lewan <d.lewan2000 <at> gmail.com> writes:

> The following ERT commands do not appear in the info doumentation for ERT and
> should.
>
> Most would be appropriate in the section "Running test interactively". Those
> commands with associated keys are mentioned in ert-results-mode, but, still,
> should appear in the info.
> The command M-x ert-delete-all-tests is especially useful for creating a clean
> slate, but it is not mentioned at all.
>
> ert-delete-all-tests
> ert-delete-test (key D)
> ert-describe-test
> ert-find-test-other-window
> ert-results-describe-test-at-point (key h)
> ert-results-jump-between-summary-and-result (key j)
> ert-results-next-test (key n)
> ert-results-pop-to-timings (key T)
> ert-results-previous-test (key p)
> ert-results-rerun-all-tests (key R)
> ert-run-tests-interactively

It would be useful to document them in the Info documentation, indeed.
Probably no one found the time to do it yet, is all.

> It would also be worth mentioning these commands defined elsewhere but with an
> interactive UI in ert-results-mode
>
> describe-mode (key ?)
> revert-buffer (key g)
> quit-window (key q)

I'm not sure we need to document these however, since they are generic
(from `special-mode') and available all over.  Presumably they would
already be familiar to almost all ELisp developers (who would the target
group of the ERT Info manual).

> I'd be happy to work on text for this if that's appropriate.

That would be both welcome and useful, thank you.

Best regards,
Stefan Kangas

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Douglas Lewan <d.lewan2000 <at> gmail.com>
Cc: 41829 <at> debbugs.gnu.org
Subject: Re: bug#41829: ERT commands that aren't in the info
Date: Sun, 18 Oct 2020 01:39:53 +0000

Stefan Kangas <stefan <at> marxist.se> writes:

>> I'd be happy to work on text for this if that's appropriate.
>
> That would be both welcome and useful, thank you.

That was 9 weeks ago, any updates here?

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Douglas Lewan <d.lewan2000 <at> gmail.com>
Cc: 41829 <at> debbugs.gnu.org
Subject: Re: bug#41829: ERT commands that aren't in the info
Date: Sat, 25 Sep 2021 08:09:37 -0700

tags 41829 fixed
close 41829 28.1
thanks

Stefan Kangas <stefan <at> marxist.se> writes:

> Douglas Lewan <d.lewan2000 <at> gmail.com> writes:
>
>> The following ERT commands do not appear in the info doumentation for ERT and
>> should.
>>
>> Most would be appropriate in the section "Running test interactively". Those
>> commands with associated keys are mentioned in ert-results-mode, but, still,
>> should appear in the info.
>> The command M-x ert-delete-all-tests is especially useful for creating a clean
>> slate, but it is not mentioned at all.
>>
>> ert-delete-all-tests
>> ert-delete-test (key D)
>> ert-describe-test
>> ert-find-test-other-window
>> ert-results-describe-test-at-point (key h)
>> ert-results-jump-between-summary-and-result (key j)
>> ert-results-next-test (key n)
>> ert-results-pop-to-timings (key T)
>> ert-results-previous-test (key p)
>> ert-results-rerun-all-tests (key R)
>> ert-run-tests-interactively
>
> It would be useful to document them in the Info documentation, indeed.
> Probably no one found the time to do it yet, is all.
[...]
>> I'd be happy to work on text for this if that's appropriate.
>
> That would be both welcome and useful, thank you.

No further updates here within a year, so I've now made this change on
master (commit c7370f7334).  This change will be part of Emacs 28.1.

Further tweaks, improvements and suggestions are welcome of course, but
for now I'm closing this bug report.  Please reply to this email (use
"Reply to all" in your email client) and we can reopen the bug report if
needed, or you could just open a new bug.

Thanks again for the bug report!

Previous Next

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