From: N. Jackson Date: Thu, 8 Jul 2021 00:43:20 +0000 (+0200) Subject: Mention what happens with timers when the computer is asleep X-Git-Tag: emacs-28.0.90~1929 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1ffc97a211f6c9153bd5433c61349ce36b9b2e7d;p=emacs.git Mention what happens with timers when the computer is asleep * doc/lispref/os.texi (Timers): Explain what happens if the computer is a asleep when the timer is scheduled (bug#23929). --- diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi index 242c5ed1522..12ddaf04b6a 100644 --- a/doc/lispref/os.texi +++ b/doc/lispref/os.texi @@ -2167,6 +2167,11 @@ if @var{time} is @code{t}, then the timer runs whenever the time is a multiple of @var{repeat} seconds after the epoch. This is useful for functions like @code{display-time}. +If Emacs didn't get any CPU time when the timer would have run (for +example if the system was busy running another process or if the +computer was sleeping or in a suspended state), the timer will run as +soon as Emacs resumes and is idle. + The function @code{run-at-time} returns a timer value that identifies the particular scheduled future action. You can use this value to call @code{cancel-timer} (see below).