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

2 files changed, 11 insertions, 0 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 61f5fe32602..0e532345c7c 100644
--- 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 aa2d92b3b04..f1a8b0aa9c1 100644
--- 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