comparison man/dired.texi @ 60103:d7a513160c01

(Dired Enter): C-x C-f can run Dired. (Dired Visiting): Comment out `a' command. Mouse-1 is like Mouse-2. (Shell Commands in Dired): ? can be used more than once.

60102:8555807a4582

@section Entering Dired

@findex dired
@kindex C-x d
@vindex dired-listing-switches
  To invoke Dired, do @kbd{C-x d} or @kbd{M-x dired}.  The command reads
a directory name or wildcard file name pattern as a minibuffer argument
to specify which files to list.  Where @code{dired} differs from
@code{list-directory} is in putting the buffer into Dired mode so that
the special commands of Dired are available.

  The variable @code{dired-listing-switches} specifies the options to
give to @code{ls} for listing directory; this string @emph{must} contain
@samp{-l}.  If you use a numeric prefix argument with the @code{dired}
command, you can specify the @code{ls} switches with the minibuffer
before you enter the directory specification.  No matter how they are
specified, the @code{ls} switches should all be short options (that
is, single characters) requiring no arguments.

@itemx e
@kindex RET @r{(Dired)}
@kindex e @r{(Dired)}
Equivalent to @kbd{f}.

@item a
@kindex a @r{(Dired)}
@findex dired-find-alternate-file
Like @kbd{f}, but replaces the contents of the Dired buffer with
that of an alternate file or directory (@code{dired-find-alternate-file}).

@item o
@kindex o @r{(Dired)}
@findex dired-find-file-other-window
Like @kbd{f}, but uses another window to display the file's buffer

@kindex C-o @r{(Dired)}
@findex dired-display-file
Visit the file described on the current line, and display the buffer in
another window, but do not select that window (@code{dired-display-file}).

@item Mouse-2
@findex dired-mouse-find-file-other-window
Visit the file named by the line you click on
(@code{dired-mouse-find-file-other-window}).  This uses another window
to display the file, like the @kbd{o} command.

For example, @kbd{! uudecode @key{RET}} runs @code{uudecode} on each
file.

@item
If the command string contains @samp{?} surrounded by whitespace, the
current file name is substituted for @samp{?}.  You can use @samp{?}
this way more than once in the command, and each occurrence is
replaced.
@end itemize

To iterate over the file names in a more complicated fashion, use an
explicit shell loop.  For example, here is how to uuencode each file,
making the output file name by appending @samp{.uu} to the input file

60103:d7a513160c01

@section Entering Dired

@findex dired
@kindex C-x d
@vindex dired-listing-switches
  To invoke Dired, do @kbd{C-x d} or @kbd{M-x dired}.  The command
reads a directory name or wildcard file name pattern as a minibuffer
argument to specify which files to list.  @kbd{C-x C-f} given a
directory name also invokes Dired.  Where @code{dired} differs from
@code{list-directory} is that it puts the buffer into Dired mode, so
that the special commands of Dired are available.

  The variable @code{dired-listing-switches} specifies the options to
give to @code{ls} for listing the directory; this string @emph{must} contain
@samp{-l}.  If you use a numeric prefix argument with the @code{dired}
command, you can specify the @code{ls} switches with the minibuffer
before you enter the directory specification.  No matter how they are
specified, the @code{ls} switches should all be short options (that
is, single characters) requiring no arguments.

@itemx e
@kindex RET @r{(Dired)}
@kindex e @r{(Dired)}
Equivalent to @kbd{f}.

@ignore  @c This command seems too risky to document at all.
@item a
@kindex a @r{(Dired)}
@findex dired-find-alternate-file
Like @kbd{f}, but replaces the contents of the Dired buffer with
that of an alternate file or directory (@code{dired-find-alternate-file}).
@end ignore

@item o
@kindex o @r{(Dired)}
@findex dired-find-file-other-window
Like @kbd{f}, but uses another window to display the file's buffer

@kindex C-o @r{(Dired)}
@findex dired-display-file
Visit the file described on the current line, and display the buffer in
another window, but do not select that window (@code{dired-display-file}).

@item Mouse-1
@itemx Mouse-2
@findex dired-mouse-find-file-other-window
Visit the file named by the line you click on
(@code{dired-mouse-find-file-other-window}).  This uses another window
to display the file, like the @kbd{o} command.

For example, @kbd{! uudecode @key{RET}} runs @code{uudecode} on each
file.

@item
However, if the command string contains @samp{?} surrounded by
whitespace, the current file name is substituted for @samp{?}  (rather
than added at the end).  You can use @samp{?} this way more than once
in the command, and the same file name replaces each occurrence.
@end itemize

To iterate over the file names in a more complicated fashion, use an
explicit shell loop.  For example, here is how to uuencode each file,
making the output file name by appending @samp{.uu} to the input file