doc/emacs/dired-xtra.texi

   1 @c This is part of the Emacs manual.
   2 @c Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
   3 @c   Free Software Foundation, Inc.
   4 @c See file emacs.texi for copying conditions.
   5 @c
   6 @c This file is included either in emacs-xtra.texi (when producing the
   7 @c printed version) or in the main Emacs manual (for the on-line version).
   8 @node Subdir Switches
   9 @section Subdirectory Switches in Dired
  10
  11 You can insert subdirectories with specified @code{ls} switches in
  12 Dired buffers using @kbd{C-u i}.  You can change the @code{ls}
  13 switches of an already inserted subdirectory using @kbd{C-u l}.
  14
  15 Dired preserves the switches if you revert the buffer.  Deleting a
  16 subdirectory forgets about its switches.
  17
  18 Using @code{dired-undo} (usually bound to @kbd{C-_} and @kbd{C-x u})
  19 to reinsert or delete subdirectories that were inserted with explicit
  20 switches can bypass Dired's machinery for remembering (or forgetting)
  21 switches.  Deleting a subdirectory using @code{dired-undo} does not
  22 forget its switches.  When later reinserted using @kbd{i}, it will be
  23 reinserted using its old switches.  Using @code{dired-undo} to
  24 reinsert a subdirectory that was deleted using the regular
  25 Dired commands (not @code{dired-undo}) will originally insert it with
  26 its old switches.  Reverting the buffer, however, will relist it using
  27 the buffer's default switches.  If any of this yields problems, you
  28 can easily correct the situation using @kbd{C-u i} or @kbd{C-u l}.
  29
  30 Dired does not remember the @code{R} switch.  Inserting a subdirectory
  31 with switches that include the @code{R} switch is equivalent to
  32 inserting each of its subdirectories using all remaining switches.
  33 For instance, updating or killing a subdirectory that was inserted
  34 with the @code{R} switch will not update or kill its subdirectories.
  35
  36 The buffer's default switches do not affect subdirectories that were
  37 inserted using explicitly specified switches.  In particular,
  38 commands such as @kbd{s} that change the buffer's switches do not
  39 affect such subdirectories.  (They do, however, affect subdirectories
  40 without explicitly assigned switches.)
  41
  42 You can make Dired forget about all subdirectory switches and relist
  43 all subdirectories with the buffer's default switches using
  44 @kbd{M-x dired-reset-subdir-switches}.  This also reverts the Dired buffer.