From 1ffc97a211f6c9153bd5433c61349ce36b9b2e7d Mon Sep 17 00:00:00 2001 From: "N. Jackson" Date: Thu, 8 Jul 2021 02:43:20 +0200 Subject: [PATCH] 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). --- doc/lispref/os.texi | 5 +++++ 1 file changed, 5 insertions(+) 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). -- 2.39.2