Re: Popup when buffer file is changed on disk

[Eli Zaretskii]

> Date: Sat, 12 Feb 2005 19:41:53 -0600 (CST)
> From: Luc Teirlinck <address@hidden>
> CC: address@hidden, address@hidden, address@hidden
> 
>   (defcustom auto-revert-stop-on-user-input t
> !   "When non-nil, user input temporarily interrupts Auto-Revert Mode.
> ! 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.  When non-nil,
> ! 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."

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.