Document `vcsh foreach`

[code/vcsh.git] / vcsh

diff --git a/vcsh b/vcsh
index 18faf4c16dd6bfef4b97eb86029e5ea83f9134c2..06f6c331edabbdc6ea2360f54e84ea0d65bf768e 100755 (executable)
--- a/vcsh
+++ b/vcsh
@@ -106,6 +106,8 @@ help() {
    commit               Commit in all repositories
    delete <repo>        Delete an existing repository
    enter <repo>         Enter repository; spawn new instance of \$SHELL
+   foreach [<-g>]
+     <git command>      Execute a command for every repository
    help                 Display this help text
    init <repo>          Initialize a new repository
    list                 List all repositories
@@ -218,11 +220,21 @@ enter() {
 
 foreach() {
        hook pre-foreach
+
+       # We default to prefixing `git` to all commands passed to foreach, but
+       # allow running in general context with -g
+       command_prefix=git
+       while getopts "g" flag; do
+               if [ x"$1" = x'-g' ]; then
+                       unset command_prefix
+               fi
+               shift 1
+       done
        for VCSH_REPO_NAME in $(list); do
                echo "$VCSH_REPO_NAME:"
                GIT_DIR=$VCSH_REPO_D/$VCSH_REPO_NAME.git; export GIT_DIR
                use
-               git "$@"
+               $command_prefix "$@"
        done
        hook post-foreach
 }