diff options
author | Junio C Hamano <gitster@pobox.com> | 2020-11-18 14:15:08 -0800 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2020-11-18 14:15:08 -0800 |
commit | b7676d5ada0941ade7ac9acb8ce985686b62b2ab (patch) | |
tree | 11ddf24c8178241b09e082064ac45508a805f0e6 /git-for-each-repo.txt | |
parent | ee43d18844df1f78dad8b389cbb393b211073d17 (diff) | |
download | git-htmldocs-b7676d5ada0941ade7ac9acb8ce985686b62b2ab.tar.gz |
Autogenerated HTML docs for v2.29.2-334-gfaefd
Diffstat (limited to 'git-for-each-repo.txt')
-rw-r--r-- | git-for-each-repo.txt | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/git-for-each-repo.txt b/git-for-each-repo.txt new file mode 100644 index 000000000..94bd19da2 --- /dev/null +++ b/git-for-each-repo.txt @@ -0,0 +1,59 @@ +git-for-each-repo(1) +==================== + +NAME +---- +git-for-each-repo - Run a Git command on a list of repositories + + +SYNOPSIS +-------- +[verse] +'git for-each-repo' --config=<config> [--] <arguments> + + +DESCRIPTION +----------- +Run a Git command on a list of repositories. The arguments after the +known options or `--` indicator are used as the arguments for the Git +subprocess. + +THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE. + +For example, we could run maintenance on each of a list of repositories +stored in a `maintenance.repo` config variable using + +------------- +git for-each-repo --config=maintenance.repo maintenance run +------------- + +This will run `git -C <repo> maintenance run` for each value `<repo>` +in the multi-valued config variable `maintenance.repo`. + + +OPTIONS +------- +--config=<config>:: + Use the given config variable as a multi-valued list storing + absolute path names. Iterate on that list of paths to run + the given arguments. ++ +These config values are loaded from system, global, and local Git config, +as available. If `git for-each-repo` is run in a directory that is not a +Git repository, then only the system and global config is used. + + +SUBPROCESS BEHAVIOR +------------------- + +If any `git -C <repo> <arguments>` subprocess returns a non-zero exit code, +then the `git for-each-repo` process returns that exit code without running +more subprocesses. + +Each `git -C <repo> <arguments>` subprocess inherits the standard file +descriptors `stdin`, `stdout`, and `stderr`. + + +GIT +--- +Part of the linkgit:git[1] suite |