From 54b01741bd61dd023d9cef12f2c1fb2890d85990 Mon Sep 17 00:00:00 2001 From: Allen Li Date: Sun, 26 Nov 2017 23:21:34 -0800 Subject: [PATCH 1/2] Clarify dired-do-shell-command docstring The docstring seemed to imply that if * and ? were used together, * would take priority. However, it is explicitly checked that * and ? are not used together. * lisp/dired-aux.el (dired-do-shell-command): Fix docstring --- lisp/dired-aux.el | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/lisp/dired-aux.el b/lisp/dired-aux.el index f1f7cf0b0e..57eb216231 100644 --- a/lisp/dired-aux.el +++ b/lisp/dired-aux.el @@ -686,13 +686,15 @@ dired-do-shell-command If there is a `*' in COMMAND, surrounded by whitespace, this runs COMMAND just once with the entire file list substituted there. -If there is no `*', but there is a `?' in COMMAND, surrounded by -whitespace, or a `\\=`?\\=`' this runs COMMAND on each file -individually with the file name substituted for `?' or `\\=`?\\=`'. +If there is a `?' in COMMAND, surrounded by whitespace, or a +`\\=`?\\=`' this runs COMMAND on each file individually with the +file name substituted for `?' or `\\=`?\\=`'. Otherwise, this runs COMMAND on each file individually with the file name added at the end of COMMAND (separated by a space). +`*' and `?' cannot be used together. + `*' and `?' when not surrounded by whitespace nor `\\=`' have no special significance for `dired-do-shell-command', and are passed through normally to the shell, but you must confirm first. -- 2.15.1