changeset 107525:cd363410df90

* dired.texi (Dired Updating): Document dired-auto-revert-buffer.
author Chong Yidong <cyd@stupidchicken.com>
date Sun, 21 Mar 2010 18:13:26 -0400
parents ec5432ca82a4
children af52c11fa4bd
files doc/emacs/ChangeLog doc/emacs/dired.texi etc/NEWS
diffstat 3 files changed, 15 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/doc/emacs/ChangeLog	Sun Mar 21 14:32:19 2010 -0400
+++ b/doc/emacs/ChangeLog	Sun Mar 21 18:13:26 2010 -0400
@@ -1,5 +1,7 @@
 2010-03-21  Chong Yidong  <cyd@stupidchicken.com>
 
+	* dired.texi (Dired Updating): Document dired-auto-revert-buffer.
+
 	* search.texi (Other Repeating Search): Document multi-isearch-buffers
 	and multi-isearch-buffers-regexp.
 
--- a/doc/emacs/dired.texi	Sun Mar 21 14:32:19 2010 -0400
+++ b/doc/emacs/dired.texi	Sun Mar 21 18:13:26 2010 -0400
@@ -1099,6 +1099,15 @@
   If you use @kbd{l} on a subdirectory header line, it updates the
 contents of the corresponding subdirectory.
 
+@vindex dired-auto-revert-buffer
+  If you use @kbd{C-x d} or some other Dired command to visit a
+directory that is already being shown in a Dired buffer, Dired
+switches to that buffer but does not update it.  If the buffer is not
+up-to-date, Dired displays a warning telling you to type @key{g} to
+update it.  You can also tell Emacs to revert each Dired buffer
+automatically when you revisit it, by setting the variable
+@code{dired-auto-revert-buffer} to a non-@code{nil} value.
+
 @kindex k @r{(Dired)}
 @findex dired-do-kill-lines
   To delete the specified @emph{file lines} from the buffer---not
--- a/etc/NEWS	Sun Mar 21 14:32:19 2010 -0400
+++ b/etc/NEWS	Sun Mar 21 18:13:26 2010 -0400
@@ -222,9 +222,9 @@
 `desktop-files-not-to-save' instead.
 
 ** Dired
-
-*** The new variable `dired-auto-revert-buffer' allows to revert
-dired buffers automatically on revisiting.
++++
+*** The new variable `dired-auto-revert-buffer', if non-nil, causes
+Dired buffers to be reverted automatically on revisiting them.
 
 ** DocView
 
@@ -544,7 +544,7 @@
 The feature `hashtable-print-readable' identifies this new
 functionality.
 
-** New functions performing Unicode normalization are added:
+** New functions for performing Unicode normalization:
 ucs-normalize-NFD-region, ucs-normalize-NFD-string,
 ucs-normalize-NFC-region, ucs-normalize-NFC-string,
 ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,