* dired.texi (Dired Updating): Document dired-auto-revert-buffer.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 61f5fe32602629993aa9c35af5564e2d44e3006f..0e532345c7cc66852c8e88ef750596668fee0895 100644 (file)
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -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.
 

diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index aa2d92b3b04d52c8618a7800168d37b55ffc62dc..f1a8b0aa9c161ba8a2f472d94a1239d7bfff4d5a 100644 (file)
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -1099,6 +1099,15 @@ then updating their lines in the buffer to indicate that status.
   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

diff --git a/etc/NEWS b/etc/NEWS
index 7416a199f5a452806f7b62fd12af5d2521433aec..6abb3e347caac3c3443e65d3fdfd2c0d337d5979 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -222,9 +222,9 @@ exempt buffers that do correspond to files, customize the value of
 `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 @@ affecting the buffer's modification state.
 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,