summaryrefslogtreecommitdiff
path: root/doc/lispref/os.texi
diff options
context:
space:
mode:
authorN. Jackson <nljlistbox2@gmail.com>2021-07-08 02:43:20 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2021-07-08 02:43:20 +0200
commit1ffc97a211f6c9153bd5433c61349ce36b9b2e7d (patch)
tree9138543bd4a904cadcd3026221cc8ece2d35bb97 /doc/lispref/os.texi
parente762864b9d501cfbc15fd20f403fc435bbdc580e (diff)
downloademacs-1ffc97a211f6c9153bd5433c61349ce36b9b2e7d.tar.gz
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).
Diffstat (limited to 'doc/lispref/os.texi')
-rw-r--r--doc/lispref/os.texi5
1 files changed, 5 insertions, 0 deletions
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).