Mercurial > emacs
diff lispref/os.texi @ 73117:43aadb7f2e64
* os.texi (Timers): Mention with-local-quit.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Mon, 25 Sep 2006 15:20:44 +0000 |
parents | ce175d3f53fd |
children | 9c30f6865f5f |
line wrap: on
line diff
--- a/lispref/os.texi Mon Sep 25 15:13:07 2006 +0000 +++ b/lispref/os.texi Mon Sep 25 15:20:44 2006 +0000 @@ -1386,7 +1386,12 @@ things in an inconsistent state. This is normally unproblematical 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. +to be annoying. If a timer function needs to allow quitting, it +should use @code{with-local-quit} (@pxref{Quitting}). For example, if +a timer function calls @code{accept-process-output} to receive output +from an external process, that call should be wrapped inside +@code{with-local-quit}, to ensure that @kbd{C-g} works if the external +process hangs. It is usually a bad idea for timer functions to alter buffer contents. When they do, they usually should call @code{undo-boundary}