Mercurial > emacs

--- a/lisp/ChangeLog	Sun Jun 28 00:47:58 2009 +0000
+++ b/lisp/ChangeLog	Sun Jun 28 00:52:23 2009 +0000
@@ -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-27  Johan Bockgård  <bojohan@gnu.org>

 	* emacs-lisp/cl-specs.el (defstruct): Fix :conc-name spec.
@@ -32,7 +37,7 @@
 2009-06-24  Michael Albinus  <michael.albinus@gmx.de>

 	* net/tramp-gvfs.el (tramp-gvfs-handle-make-directory): Use `dir'
-	but `filename'.
+	rather than `filename'.

 2009-06-23  Miles Bader  <miles@gnu.org>
--- a/lisp/autorevert.el	Sun Jun 28 00:47:58 2009 +0000
+++ b/lisp/autorevert.el	Sun Jun 28 00:52:23 2009 +0000
@@ -207,10 +207,13 @@
 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 @@

 ;;;###autoload
 (define-minor-mode global-auto-revert-mode
-  "Revert any buffer when file on disk changes.
+  "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.

-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."
+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