Re: Repeating timers and suspending the computer

[Marcin Borkowski]

On 2022-12-15, at 07:11, Eli Zaretskii <eliz@gnu.org> wrote:

>> From: Marcin Borkowski <mbork@mbork.pl>
>> Cc: help-gnu-emacs@gnu.org
>> Date: Wed, 14 Dec 2022 21:13:37 +0100
>>
>>
>> On 2022-12-13, at 13:32, Eli Zaretskii <eliz@gnu.org> wrote:
>>
>> >> Do I get it correctly that this means that of the scheduled number of
>> >> repeats is /less/ than `timer-max-repeats', then all of them get
>> >> executed, but when it is greater than that, only one of them is?
>> >
>> > That's the idea, yes.
>>
>> Thanks.  Any ideas how to rephrase the manual so that it is unambiguous?
>
> I'm not sure I see why that matters.

--8<---------------cut here---------------start------------->8---
If after careful rereading of the manual you still do not understand
what the command should do, that indicates a bug in the manual, which
you should report. The manual’s job is to make everything clear to
people who are not Emacs experts—including you. It is just as important
to report documentation bugs as program bugs.
--8<---------------cut here---------------end--------------->8---

(https://www.gnu.org/software/emacs/manual/html_node/emacs/Bug-Criteria.html)

I agree that it is not extremely important, but an unclear manual is
still a bug, right?

Best,

-- 
Marcin Borkowski
http://mbork.pl