From 2cc7ffcd61352b55d7c010c7524a739b3fe13c80 Mon Sep 17 00:00:00 2001
From: Richard Hartmann <richih@debian.org>
Date: Sat, 19 Dec 2015 11:38:20 +0100
Subject: [PATCH] Document `vcsh foreach`

---
 _vcsh           |  5 +++++
 doc/vcsh.1.ronn |  7 +++++++
 vcsh            | 14 +++++++++++++-
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/_vcsh b/_vcsh
index 53eaada..6562dc5 100644
--- a/_vcsh
+++ b/_vcsh
@@ -23,6 +23,10 @@ function _vcsh-enter () {
 	(( CURRENT == 2 )) && __vcsh_repositories
 }
 
+function _vcsh-foreach () {
+	_dispatch git git
+}
+
 function _vcsh-help () {
 	_nothing
 }
@@ -100,6 +104,7 @@ function _vcsh () {
 		"commit:commit in all repositories"
 		"delete:delete an existing repository"
 		"enter:enter repository; spawn new <\$SHELL>"
+		"foreach:execute for all repos"
 		"help:display help"
 		"init:initialize an empty repository"
 		"list:list all local vcsh repositories"
diff --git a/doc/vcsh.1.ronn b/doc/vcsh.1.ronn
index 2bf8a77..d5ee0dc 100644
--- a/doc/vcsh.1.ronn
+++ b/doc/vcsh.1.ronn
@@ -11,6 +11,8 @@ vcsh(1) - Version Control System for $HOME - multiple Git repositories in $HOME
 
 `vcsh` enter <repo>
 
+`vcsh` foreach [-g] <git command>
+
 `vcsh` help
 
 `vcsh` init <repo>
@@ -98,6 +100,11 @@ an interactive user.
 * enter:
   Enter repository; spawn new <$SHELL>.
 
+* foreach:
+  Execute git command for every vcsh repository.
+
+  `-g`: Execute in general context.
+
 * help:
   Display help.
 
diff --git a/vcsh b/vcsh
index 18faf4c..06f6c33 100755
--- 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
 }
-- 
GitLab