# HG changeset patch # User Glenn Morris # Date 1246153323 0 # Node ID 373ed9f0e72831041a68fec6acdfaf37a92139d5 # Parent 3e9859a4c09759f2c9cf6749272d66cc777efb3f Minor revisions. diff -r 3e9859a4c097 -r 373ed9f0e728 doc/emacs/ChangeLog --- a/doc/emacs/ChangeLog Sun Jun 28 00:52:23 2009 +0000 +++ b/doc/emacs/ChangeLog Sun Jun 28 01:42:03 2009 +0000 @@ -2,6 +2,8 @@ * arevert-xtra.texi: Minor language tweaks. + * dired-xtra.texi: Minor revisions. + 2009-06-23 Miles Bader * display.texi (Scrolling): Document `recenter-redisplay' diff -r 3e9859a4c097 -r 373ed9f0e728 doc/emacs/dired-xtra.texi --- a/doc/emacs/dired-xtra.texi Sun Jun 28 00:52:23 2009 +0000 +++ b/doc/emacs/dired-xtra.texi Sun Jun 28 01:42:03 2009 +0000 @@ -1,5 +1,6 @@ @c This is part of the Emacs manual. -@c Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. +@c Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009 +@c Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @c This file is included either in emacs-xtra.texi (when producing the @@ -8,37 +9,35 @@ @section Subdirectory Switches in Dired You can insert subdirectories with specified @code{ls} switches in -Dired buffers, using @kbd{C-u i}. You can change the @code{ls} +Dired buffers using @kbd{C-u i}. You can change the @code{ls} switches of an already inserted subdirectory using @kbd{C-u l}. -In Emacs versions 22.1 and later, Dired remembers the switches, so -that reverting the buffer will not change them back to the main -directory's switches. Deleting a subdirectory forgets about its -switches. +Dired preserves the switches if you revert the buffer. Deleting a +subdirectory forgets about its switches. Using @code{dired-undo} (usually bound to @kbd{C-_} and @kbd{C-x u}) -to reinsert or delete subdirectories, that were inserted with explicit -switches, can bypass Dired's machinery for remembering (or forgetting) +to reinsert or delete subdirectories that were inserted with explicit +switches can bypass Dired's machinery for remembering (or forgetting) switches. Deleting a subdirectory using @code{dired-undo} does not forget its switches. When later reinserted using @kbd{i}, it will be reinserted using its old switches. Using @code{dired-undo} to reinsert a subdirectory that was deleted using the regular Dired commands (not @code{dired-undo}) will originally insert it with -its old switches. However, reverting the buffer will relist it using +its old switches. Reverting the buffer, however, will relist it using the buffer's default switches. If any of this yields problems, you can easily correct the situation using @kbd{C-u i} or @kbd{C-u l}. Dired does not remember the @code{R} switch. Inserting a subdirectory -with switches that include the @code{R} switch is equivalent with +with switches that include the @code{R} switch is equivalent to inserting each of its subdirectories using all remaining switches. For instance, updating or killing a subdirectory that was inserted with the @code{R} switch will not update or kill its subdirectories. The buffer's default switches do not affect subdirectories that were inserted using explicitly specified switches. In particular, -commands such as @kbd{s}, that change the buffer's switches do not -affect such subdirectories. (They do affect subdirectories without -explicitly assigned switches, however.) +commands such as @kbd{s} that change the buffer's switches do not +affect such subdirectories. (They do, however, affect subdirectories +without explicitly assigned switches.) You can make Dired forget about all subdirectory switches and relist all subdirectories with the buffer's default switches using