1f010d6bdf
We presently use the ".txt" extension for our AsciiDoc files. While not wrong, most editors do not associate this extension with AsciiDoc, meaning that contributors don't get automatic editor functionality that could be useful, such as syntax highlighting and prose linting. It is much more common to use the ".adoc" extension for AsciiDoc files, since this helps editors automatically detect files and also allows various forges to provide rich (HTML-like) rendering. Let's do that here, renaming all of the files and updating the includes where relevant. Adjust the various build scripts and makefiles to use the new extension as well. Note that this should not result in any user-visible changes to the documentation. Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
69 lines
1.9 KiB
Plaintext
69 lines
1.9 KiB
Plaintext
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.
|
|
|
|
--keep-going::
|
|
Continue with the remaining repositories if the command failed
|
|
on a repository. The exit code will still indicate that the
|
|
overall operation was not successful.
|
|
+
|
|
Note that the exact exit code of the failing command is not passed
|
|
through as the exit code of the `for-each-repo` command: If the command
|
|
failed in any of the specified repositories, the overall exit code will
|
|
be 1.
|
|
|
|
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
|