1 files changed, 4 insertions, 5 deletions

diff --git a/lisp/files.el b/lisp/files.el
index fd97afa3073..c098cbcc7ff 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -3461,11 +3461,10 @@ Auto Revert Mode sets NOCONFIRM to t.  The function should return
 non-nil if the buffer should be reverted.  The buffer is current
 when this function is called.
 
-The idea behind the NOCONFIRM argument is that the same function
-can also be used to ask the user whether the buffer should be
-reverted.  In such a situation one has to be less careful about,
-say, reverting remote files, than if the function is called at
-regular intervals by Auto Revert Mode.")
+The idea behind the NOCONFIRM argument is that it should be t if
+the buffer is going to be reverted without asking the user.  In
+such situations, one has to be careful with potentially time
+consuming operations.")
 
 (defvar before-revert-hook nil
   "Normal hook for `revert-buffer' to run before reverting.