[Emacs-diffs] Changes to emacs/lispref/os.texi,v

[Richard M. Stallman]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Richard M. Stallman <rms>       06/09/04 15:07:33

Index: os.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/os.texi,v
retrieving revision 1.93
retrieving revision 1.94
diff -u -b -r1.93 -r1.94
--- os.texi     25 Aug 2006 07:51:46 -0000      1.93
+++ os.texi     4 Sep 2006 15:07:32 -0000       1.94
@@ -1578,6 +1578,25 @@
 @end smallexample
 @end defun
 
+  Some idle timer functions in user Lisp packages have a loop that
+does a certain amount of processing each time around, and exits when
address@hidden(input-pending-p)} is address@hidden  That approach seems very
+natural but has two problems:
+
address@hidden
address@hidden
+It blocks out all process output (since Emacs accepts process output
+only while waiting).
+
address@hidden
+It blocks out any idle timers that ought to run during that time.
address@hidden itemize
+
address@hidden
+To avoid these problems, don't use that technique.  Instead, write
+such idle timers to reschedule themselves after a brief pause, using
+the method in the @code{timer-function} example above.
+
 @node Terminal Input
 @section Terminal Input
 @cindex terminal input