Re: Popup when buffer file is changed on disk

[Luc Teirlinck]

Eli Zaretskii wrote:
   
   I think you should describe the effects of each possible value (nil
   and non-nil) without intermixing them.  The way this doc string goes,
   it's confusing: first you say what happens under a non-nil value, then
   under nil value, then again under non-nil.

What about the following?

(defcustom auto-revert-stop-on-user-input t
  "When non-nil, user input temporarily interrupts Auto-Revert Mode.
More precisely, Auto-Revert Mode checks for user input after
handling each buffer and does not process any further
buffers (until the next run of the timer) if user input is
available.  When nil, Auto-Revert Mode checks files and reverts
buffers, with quitting disabled, without paying attention to user
input.  Thus, Emacs could appear to be hung for a while."
  :group 'auto-revert
  :type 'boolean)