[Emacs-diffs] Changes to emacs/lispref/commands.texi

[Richard M . Stallman]

Index: emacs/lispref/commands.texi
diff -c emacs/lispref/commands.texi:1.69 emacs/lispref/commands.texi:1.70
*** emacs/lispref/commands.texi:1.69    Mon Jul 18 15:38:19 2005
--- emacs/lispref/commands.texi Tue Aug  9 12:00:09 2005
***************
*** 2435,2449 ****
  @end defvar
  
  @defmac while-no-input body...
! This construct runs the @var{body} forms and returns the value
! of the last one---but only if no input arrives.  If any input
! arrives during the execution of the @var{body} forms, it aborts
! them (working much like a quit), and the @code{while-no-input}
! form returns @code{nil}.
  
  If a part of @var{body} binds @code{inhibit-quit} to address@hidden,
  arrival of input during those parts won't cause an abort until
  the end of that part.
  @end defmac
  
  @defun discard-input
--- 2435,2460 ----
  @end defvar
  
  @defmac while-no-input body...
! This construct runs the @var{body} forms and returns the value of the
! last one---but only if no input arrives.  If any input arrives during
! the execution of the @var{body} forms, it aborts them (working much
! like a quit).  The @code{while-no-input} form returns @code{nil} if
! aborted by a real quit, and returns @code{t} if aborted by arrival of
! other input.
  
  If a part of @var{body} binds @code{inhibit-quit} to address@hidden,
  arrival of input during those parts won't cause an abort until
  the end of that part.
+ 
+ If you want to be able to distingish all possible values computed
+ by @var{body} from both kinds of abort conditions, write the code
+ like this:
+ 
+ @example
+ (while-no-input
+   (list
+     (progn . @var{body})))
+ @end example
  @end defmac
  
  @defun discard-input