Mercurial > emacs
changeset 45634:b040bc30279e
(dired-do-shell-command): Doc fix in autoload.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Mon, 03 Jun 2002 22:58:20 +0000 |
parents | 929f8c01b822 |
children | 6bd997a303f0 |
files | lisp/dired.el |
diffstat | 1 files changed, 24 insertions(+), 9 deletions(-) [+] |
line wrap: on
line diff
--- a/lisp/dired.el Mon Jun 03 22:57:40 2002 +0000 +++ b/lisp/dired.el Mon Jun 03 22:58:20 2002 +0000 @@ -2845,18 +2845,33 @@ the next ARG files are used. Just \\[universal-argument] means the current file. The prompt mentions the file(s) or the marker, as appropriate. -If there is output, it goes to a separate buffer. +If there is a `*' in COMMAND, surrounded by whitespace, this runs +COMMAND just once with the entire file list substituted there. -Normally the command is run on each file individually. -However, if there is a `*' in the command then it is run -just once with the entire file list substituted there. +If there is no `*', but there is a `?' in COMMAND, surrounded by +whitespace, this runs COMMAND on each file individually with the +file name substituted for `?'. + +Otherwise, this runs COMMAND on each file individually with the +file name added at the end of COMMAND (separated by a space). -No automatic redisplay of dired buffers is attempted, as there's no -telling what files the command may have changed. Type -\\[dired-do-redisplay] to redisplay the marked files. +`*' and `?' when not surrounded by whitespace have no special +significance for `dired-do-shell-command', and are passed through +normally to the shell, but you must confirm first. To pass `*' by +itself to the shell as a wildcard, type `*\"\"'. + +If COMMAND produces output, it goes to a separate buffer. -The shell command has the top level directory as working directory, so -output files usually are created there instead of in a subdir." +This feature does not try to redisplay Dired buffers afterward, as +there's no telling what files COMMAND may have changed. +Type \\[dired-do-redisplay] to redisplay the marked files. + +When COMMAND runs, its working directory is the top-level directory of +the Dired buffer, so output files usually are created there instead of +in a subdir. + +In a noninteractive call (from Lisp code), you must specify +the list of file names explicitly with the FILE-LIST argument." t) (autoload 'dired-do-kill-lines "dired-aux"