(global-auto-revert-non-file-buffers): Update docstring.

1 files changed, 6 insertions, 10 deletions

diff --git a/lisp/autorevert.el b/lisp/autorevert.el
index 5cc57883110..c7a65a867e3 100644
--- a/lisp/autorevert.el
+++ b/lisp/autorevert.el
@@ -178,17 +178,13 @@ would only waste precious space."
 
 When non-nil, both file buffers and buffers with a custom
 `revert-buffer-function' and a `buffer-stale-function' are
-reverted by Global Auto-Revert Mode.
+reverted by Global Auto-Revert mode.  These include the Buffer
+List buffer, and Dired buffers showing complete local
+directories.  Dired buffers do not auto-revert as a result of
+changes in subdirectories or in the contents, size, modes, etc.,
+of files.  You may still sometimes want to revert them manually.
 
-Use this option with care since it could lead to excessive reverts.
-Note also that for some non-file buffers the check whether the
-buffer needs updating may be imperfect, due to efficiency
-considerations, and may not take all information listed in the
-buffer into account.  Hence, a non-nil value for this option does
-not necessarily make manual updates useless for non-file buffers.
-
-To find out to which buffers this option currently applies, as
-well as for further details, see Info node `(emacs-xtra)Autorevert'."
+For more information, see Info node `(emacs-xtra)Autorevert'."
   :group 'auto-revert
   :type 'boolean
   :link '(info-link "(emacs-xtra)Autorevert"))