magit-shell-command{,-topdir}: new commands

3 files changed, 64 insertions, 24 deletions

diff --git a/Documentation/RelNotes/2.2.0.txt b/Documentation/RelNotes/2.2.0.txt
index 52b3e8d..302d6ac 100644
--- a/Documentation/RelNotes/2.2.0.txt
+++ b/Documentation/RelNotes/2.2.0.txt
@@ -164,6 +164,8 @@ Changes since v2.1.0
 
 * New face `magit-section-secondary-heading'.
 
+* New commands `magit-shell-command' and `magit-shell-command-topdir'.
+
 This release also contains various documentation fixes, code
 clean-ups, bug fixes, and other small to medium improvements.
 
diff --git a/Documentation/magit.org b/Documentation/magit.org
index fe18abb..11bd68c 100644
--- a/Documentation/magit.org
+++ b/Documentation/magit.org
@@ -979,31 +979,46 @@ switch to a shell.
 
 - Key: !, magit-run-popup
 
-  Show the popup buffer featuring the below suffix commands.
+  Shows the popup buffer featuring the below suffix commands.
+
+These suffix commands run a Git subcommand.  The user input has to
+begin with the subcommand, "git" is assumed.
 
 - Key: ! !, magit-git-command-topdir
 
-  Execute a Git subcommand asynchronously, displaying the output.
+  This command reads a Git subcommand from the user and executes it in
+  the top-level directory of the current repository.
 
-  With a prefix argument run Git in the root of the current
-  repository.
+- Key: ! p, magit-git-command
+
+  This command reads a Git subcommand from the user and executes it in
+  ~default-directory~.  With a prefix argument the command is executed
+  in the top-level directory of the current repository instead.
+
+These suffix commands run arbitrary shell commands.
+
+- Key: ! !, magit-shell-command-topdir
+
+  This command reads a shell command from the user and executes it in
+  the top-level directory of the current repository.
 
-- Key: ! :, magit-git-command
+- Key: ! p, magit-shell-command
 
-  Execute a Git subcommand asynchronously, displaying the output.
-  Run Git in the top-level directory of the current repository.
+  This command reads a shell command from the user and executes it in
+  ~default-directory~.  With a prefix argument the command is executed
+  in the top-level directory of the current repository instead.
 
-This popup also features some commands that start external gui tools.
+These suffix commands start external gui tools.
 
 - Key: ! g, magit-run-git-gui
 
-  Run ~git gui~ for the current git repository.
+  Runs ~git gui~ for the current git repository.
 
 - Key: ! k, magit-run-gitk
 
-  Run Gitk for the current git repository.
+  Runs Gitk for the current git repository.
 
-  Run ~gitk --all~.  With a prefix argument run gitk without any
+  Runs ~gitk --all~.  With a prefix argument run gitk without any
   arguments.
 
 *** Git executable
diff --git a/Documentation/magit.texi b/Documentation/magit.texi
index d193ebe..b9a5474 100644
--- a/Documentation/magit.texi
+++ b/Documentation/magit.texi
@@ -1368,41 +1368,64 @@ switch to a shell.
 @cindex magit-run-popup
 @item @kbd{!} @tie{}@tie{}@tie{}@tie{}(@code{magit-run-popup})
 
-Show the popup buffer featuring the below suffix commands.
+Shows the popup buffer featuring the below suffix commands.
+@end table
+
+These suffix commands run a Git subcommand.  The user input has to
+begin with the subcommand, "git" is assumed.
 
+@table @asis
 @kindex ! !
 @cindex magit-git-command-topdir
 @item @kbd{! !} @tie{}@tie{}@tie{}@tie{}(@code{magit-git-command-topdir})
 
-Execute a Git subcommand asynchronously, displaying the output.
+This command reads a Git subcommand from the user and executes it in
+the top-level directory of the current repository.
 
-With a prefix argument run Git in the root of the current
-repository.
-
-@kindex ! :
+@kindex ! p
 @cindex magit-git-command
-@item @kbd{! :} @tie{}@tie{}@tie{}@tie{}(@code{magit-git-command})
+@item @kbd{! p} @tie{}@tie{}@tie{}@tie{}(@code{magit-git-command})
+
+This command reads a Git subcommand from the user and executes it in
+@code{default-directory}.  With a prefix argument the command is executed
+in the top-level directory of the current repository instead.
+@end table
+
+These suffix commands run arbitrary shell commands.
+
+@table @asis
+@kindex ! !
+@cindex magit-shell-command-topdir
+@item @kbd{! !} @tie{}@tie{}@tie{}@tie{}(@code{magit-shell-command-topdir})
+
+This command reads a shell command from the user and executes it in
+the top-level directory of the current repository.
+
+@kindex ! p
+@cindex magit-shell-command
+@item @kbd{! p} @tie{}@tie{}@tie{}@tie{}(@code{magit-shell-command})
 
-Execute a Git subcommand asynchronously, displaying the output.
-Run Git in the top-level directory of the current repository.
+This command reads a shell command from the user and executes it in
+@code{default-directory}.  With a prefix argument the command is executed
+in the top-level directory of the current repository instead.
 @end table
 
-This popup also features some commands that start external gui tools.
+These suffix commands start external gui tools.
 
 @table @asis
 @kindex ! g
 @cindex magit-run-git-gui
 @item @kbd{! g} @tie{}@tie{}@tie{}@tie{}(@code{magit-run-git-gui})
 
-Run @code{git gui} for the current git repository.
+Runs @code{git gui} for the current git repository.
 
 @kindex ! k
 @cindex magit-run-gitk
 @item @kbd{! k} @tie{}@tie{}@tie{}@tie{}(@code{magit-run-gitk})
 
-Run Gitk for the current git repository.
+Runs Gitk for the current git repository.
 
-Run @code{gitk --all}.  With a prefix argument run gitk without any
+Runs @code{gitk --all}.  With a prefix argument run gitk without any
 arguments.
 @end table