Subject: Re: bug#37875: 27.0.50; `run-with-timer' not documented in (elisp)Timers

From: Eli Zaretskii <[email-masked]>
Date: Tue, 29 Oct 2019 14:31:46 +0200

> From: Lars Ingebrigtsen <[email-masked]>
> Cc: [email-masked],  [email-masked],  [email-masked]
> Date: Tue, 29 Oct 2019 12:20:38 +0100
> 
> Eli Zaretskii <[email-masked]> writes:
> 
> > And if you look up the last match, you will see that run-after-delay
> > was added on the same day timer.el got rewritten using the internal
> > timers (before that -- oh horror! -- it worked by running an external
> > program which delivered a signal to Emacs when the time came).
> 
> Geez.

Yeah.

> > Does that answer your question?
> 
> Not really -- I wondered why there were two functions (run-with-timer
> and run-at-time) that are identical.

Because they aren't identical, see Phil's response.  run-after-delay
was just that: it would run the function after a delay of SECS, and
that argument isn't supposed to be anything but a number of seconds to
wait from NOW.