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

doc/emacs/ChangeLog

 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.
 

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

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,