documentation: add documentation for 'git version'

While 'git version' is probably the least complex git command,
it is a non-experimental user-facing builtin command. As such
it should have a help page.

Both `git help` and `git version` can be called as options
(`--help`/`--version`) that internally get converted to the
corresponding command. Add a small paragraph to
Documentation/git.txt describing how these two options
interact with each other and link to this help page for the
sub-options that `--version` can take. Well, currently there
is only one sub-option, but that could potentially increase
in future versions of Git.

Signed-off-by: Matthias Aßhauer <>
Signed-off-by: Junio C Hamano <>
This commit is contained in:
Matthias Aßhauer 2021-09-14 13:27:18 +00:00 committed by Junio C Hamano
parent 225bc32a98
commit b6d8887d3d
2 changed files with 32 additions and 0 deletions

View File

@ -0,0 +1,28 @@
git-version - Display version information about Git
'git version' [--build-options]
With no options given, the version of 'git' is printed on the standard output.
Note that `git --version` is identical to `git version` because the
former is internally converted into the latter.
Include additional information about how git was built for diagnostic
Part of the linkgit:git[1] suite

View File

@ -41,6 +41,10 @@ OPTIONS
Prints the Git suite version that the 'git' program came from.
This option is internaly converted to `git version ...` and accepts
the same options as the linkgit:git-version[1] command. If `--help` is
also given, it takes precedence over `--version`.
Prints the synopsis and a list of the most commonly used