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

lisp/ChangeLog

+2004-06-18  Luc Teirlinck  <teirllm@auburn.edu>
+
+	* autorevert.el (global-auto-revert-non-file-buffers): Update
+	docstring.
+
 2004-06-19  Daniel Pfeiffer  <occitan@esperanto.org>
 
 	* progmodes/compile.el (compilation-error-properties): Store one

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"))