From c734ae59326fb107e3b5d6078fd19d5f45451b67 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Sat, 1 Jan 2005 03:51:46 +0000 Subject: [PATCH] (Timers): Update previous change. --- lispref/ChangeLog | 4 ++++ lispref/os.texi | 13 ++++--------- 2 files changed, 8 insertions(+), 9 deletions(-) diff --git a/lispref/ChangeLog b/lispref/ChangeLog index c245d26870d..5d727172dba 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,7 @@ +2004-12-31 Richard M. Stallman + + * os.texi (Timers): Update previous change. + 2004-12-30 Kim F. Storm * display.texi (Line Height): Total line-height is now specified diff --git a/lispref/os.texi b/lispref/os.texi index 36d7f960850..ebc27224c96 100644 --- a/lispref/os.texi +++ b/lispref/os.texi @@ -1368,10 +1368,10 @@ because most timer functions don't do a lot of work. Indeed, for a timer to call a function that takes substantial time to run is likely to be annoying. - Timer functions should normally not alter the current buffer -contents, but it may be ok to alter some other buffer that exists for -special purposes. A general guideline is that if a buffer has undo -enabled, timers should not write in it. + It is usually a bad idea for timer functions to alter buffer +contents. When they do, they usually should call @code{undo-boundary} +both before and after changing the buffer, to separate the timer's +changes from user commands' changes. @deffn Command run-at-time time repeat function &rest args This sets up a timer that calls the function @var{function} with @@ -1486,11 +1486,6 @@ minutes, and even if there have been garbage collections and autosaves. input. Then it becomes idle again, and all the idle timers that are set up to repeat will subsequently run another time, one by one. - It is legitimate for an idle timer to edit the current buffer. If -it does, it should explicitly call @code{undo-boundary} once at the -beginning and once just before exiting, since Emacs won't do that -automatically for an idle timer. - @defun cancel-timer timer Cancel the requested action for @var{timer}, which should be a value previously returned by @code{run-at-time} or @code{run-with-idle-timer}. -- 2.39.2