From: Glenn Morris <rgm@gnu.org>
Date: Sun, 28 Jun 2009 00:50:32 +0000 (+0000)
Subject: (global-auto-revert-non-file-buffers, global-auto-revert-mode): Doc fixes.
X-Git-Tag: emacs-pretest-23.0.96~72
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=19e3cb6c1b41b4764f2b48ade1afd674155491b1;p=emacs.git

(global-auto-revert-non-file-buffers, global-auto-revert-mode): Doc fixes.
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 4089ea0339a..383c78b1ca8 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2009-06-28  Glenn Morris  <rgm@gnu.org>
+
+	* autorevert.el (global-auto-revert-non-file-buffers)
+	(global-auto-revert-mode): Doc fixes.
+
 2009-06-24  Glenn Morris  <rgm@gnu.org>
 
 	* comint.el (comint-insert-input): Doc fix.
diff --git a/lisp/autorevert.el b/lisp/autorevert.el
index 5eb6fb07f9a..ab133af00f1 100644
--- a/lisp/autorevert.el
+++ b/lisp/autorevert.el
@@ -207,10 +207,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.  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.
+List buffer displayed by `buffer-menu', and Dired buffers showing
+complete local directories.  The Buffer List buffer reverts every
+`auto-revert-interval' seconds; Dired buffers when the file list of
+the main directory changes.  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 auto-reverts.
 For more information, see Info node `(emacs)Autorevert'."
@@ -374,11 +377,23 @@ This function is designed to be added to hooks, for example:
 
 ;;;###autoload
 (define-minor-mode global-auto-revert-mode
-  "Revert any buffer when file on disk changes.
-
-With arg, turn Auto Revert mode on globally if and only if arg is positive.
-This is a minor mode that affects all buffers.
-Use `auto-revert-mode' to revert a particular buffer."
+  "Toggle Global Auto Revert mode.
+With optional prefix argument ARG, enable Global Auto Revert Mode
+if ARG > 0, else disable it.
+
+This is a global minor mode that reverts any buffer associated
+with a file when the file changes on disk.  Use `auto-revert-mode'
+to revert a particular buffer.
+
+If `global-auto-revert-non-file-buffers' is non-nil, this mode
+may also revert some non-file buffers, as described in the
+documentation of that variable.  It ignores buffers with modes
+matching `global-auto-revert-ignore-modes', and buffers with a
+non-nil vale of `global-auto-revert-ignore-buffer'.
+
+This function calls the hook `global-auto-revert-mode-hook'.
+It displays the text that `global-auto-revert-mode-text'
+specifies in the mode line."
   :global t :group 'auto-revert :lighter global-auto-revert-mode-text
   (auto-revert-set-timer)
   (when global-auto-revert-mode