master 1ffc97a: Mention what happens with timers when the computer is asleep

[Lars Ingebrigtsen]

branch: master
commit 1ffc97a211f6c9153bd5433c61349ce36b9b2e7d
Author: N. Jackson <nljlistbox2@gmail.com>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    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 242c5ed..12ddaf0 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).