From 8b74f389a81fdd6de3cbe06e8f55ffb719c183d6 Mon Sep 17 00:00:00 2001
From: Bastien Guerry <bzg@altern.org>
Date: Wed, 5 Mar 2008 17:12:17 +0000
Subject: [PATCH] * dired.texi (Hiding Subdirectories): Documented
 `dired-hide-subdir'.

---
 doc/emacs/ChangeLog  |  4 ++++
 doc/emacs/dired.texi | 15 ++++++++++-----
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index f1b9903f3a7..edd2e147af9 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2008-03-05  Drew Adams <drew.adams@oracle.com>  (tiny change)
+
+	* dired.texi (Hiding Subdirectories): Documented `dired-hide-subdir'.
+
 2008-02-28  Kim F. Storm  <storm@cua.dk>
 
 	* help.texi (Help Files): Move describe-gnu-project to C-h g.
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index afa4ffee2a7..76399cf3cd2 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -919,7 +919,8 @@ describing that subdirectory).
 
 Use the @kbd{l} command (@code{dired-do-redisplay}) to update the
 subdirectory's contents.  Use @kbd{C-u k} on the subdirectory header
-line to delete the subdirectory.  @xref{Dired Updating}.
+line to delete the subdirectory.  @xref{Dired Updating}.  You can also
+hide and show inserted subdirectories @xref{Hiding Subdirectories}.
 
 
 
@@ -981,8 +982,9 @@ Move down to the next directory-file line (@code{dired-prev-dirline}).
 
 @node Hiding Subdirectories
 @section Hiding Subdirectories
+@cindex hiding subdirectories (Dired)
+@cindex showing hidden subdirectories (Dired)
 
-@cindex hiding in Dired (Dired)
   @dfn{Hiding} a subdirectory means to make it invisible, except for its
 header line.
 
@@ -990,9 +992,9 @@ header line.
 @item $
 @findex dired-hide-subdir
 @kindex $ @r{(Dired)}
-Hide or reveal the subdirectory that point is in, and move point to the
-next subdirectory (@code{dired-hide-subdir}).  A numeric argument serves
-as a repeat count.
+Hide or show the subdirectory that point is in, and move point to the
+next subdirectory (@code{dired-hide-subdir}).  This is a toggle.  A
+numeric argument serves as a repeat count.
 
 @item M-$
 @findex dired-hide-all
@@ -1011,6 +1013,9 @@ can use hiding to temporarily exclude subdirectories from operations
 without having to remove the Dired marks on files in those
 subdirectories.
 
+@xref{Dired Updating} about inserting or deleting a subdirectory
+listing.
+
 @node Dired Updating
 @section Updating the Dired Buffer
 @cindex updating Dired buffer
-- 
2.39.5