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

[Eli Zaretskii]

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: michael_heerdegen@web.de,  psainty@orcon.net.nz,  37875@debbugs.gnu.org
> Date: Tue, 29 Oct 2019 12:20:38 +0100
> 
> Eli Zaretskii <eliz@gnu.org> 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.