[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/os.texi
From: |
Richard M . Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/os.texi |
Date: |
Fri, 31 Dec 2004 23:03:12 -0500 |
Index: emacs/lispref/os.texi
diff -c emacs/lispref/os.texi:1.67 emacs/lispref/os.texi:1.68
*** emacs/lispref/os.texi:1.67 Wed Dec 29 20:10:57 2004
--- emacs/lispref/os.texi Sat Jan 1 03:51:39 2005
***************
*** 1368,1377 ****
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.
@deffn Command run-at-time time repeat function &rest args
This sets up a timer that calls the function @var{function} with
--- 1368,1377 ----
timer to call a function that takes substantial time to run is likely
to be annoying.
! 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,1496 ****
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}.
--- 1486,1491 ----