[Emacs-diffs] /srv/bzr/emacs/trunk r110732: Document dired-do-async-shell-command changes.

[Chong Yidong]

------------------------------------------------------------
revno: 110732
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Tue 2012-10-30 07:48:02 +0800
message:
  Document dired-do-async-shell-command changes.
  
  * dired.texi (Shell Commands in Dired): Document changes to the
  dired-do-async-shell-command.
modified:
  doc/emacs/ChangeLog
  doc/emacs/dired.texi
  etc/NEWS

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-10-28 00:16:55 +0000
+++ b/doc/emacs/ChangeLog       2012-10-29 23:48:02 +0000
@@ -1,3 +1,8 @@
+2012-10-29  Chong Yidong  <address@hidden>
+
+       * dired.texi (Shell Commands in Dired): Document changes to the
+       dired-do-async-shell-command.
+
 2012-10-28  Glenn Morris  <address@hidden>
 
        * ack.texi (Acknowledgments): Mention gv.el.

=== modified file 'doc/emacs/dired.texi'
--- a/doc/emacs/dired.texi      2012-10-24 14:38:49 +0000
+++ b/doc/emacs/dired.texi      2012-10-29 23:48:02 +0000
@@ -799,15 +799,20 @@
 @kindex ! @r{(Dired)}
 @kindex X @r{(Dired)}
 The Dired command @kbd{!} (@code{dired-do-shell-command}) reads a
-shell command string in the minibuffer and runs that shell command on
+shell command string in the minibuffer, and runs that shell command on
 one or more files.  The files that the shell command operates on are
 determined in the usual way for Dired commands (@pxref{Operating on
 Files}).  The command @kbd{X} is a synonym for @kbd{!}.
 
   The command @kbd{&} (@code{dired-do-async-shell-command}) does the
-same, except that it runs the shell command asynchronously.  You can
+same, except that it runs the shell command asynchronously.  (You can
 also do this with @kbd{!}, by appending a @samp{&} character to the
-end of the shell command.
+end of the shell command.)  When the command operates on more than one
+file, it runs multiple parallel copies of the specified shell command,
+one for each file.  As an exception, if the specified shell command
+ends in @samp{;} or @samp{;&}, the shell command is run in the
+background on each file sequentially; Emacs waits for each invoked
+shell command to terminate before running the next one.
 
   For both @kbd{!} and @kbd{&}, the working directory for the shell
 command is the top-level directory of the Dired buffer.

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-10-28 02:34:36 +0000
+++ b/etc/NEWS  2012-10-29 23:48:02 +0000
@@ -397,7 +397,7 @@
 whitespace problems introduced by the diff.
 
 ** Dired
-
++++
 *** `dired-do-async-shell-command' executes each file sequentially
 if the command ends in `;' (when operating on multiple files).
 Otherwise, it executes the command on each file in parallel.