Browse files

Support "git cmd --help" syntax

The "--help" argument is special, in that it is (along with "--version")
in that is taken by the "git" program itself rather than the sub-command,
and thus we've had the syntax "git --help cmd".

However, as anybody who has ever used CVS or some similar devil-spawn
program, it's confusing as h*ll when options before the sub-command act
differently from options after the sub-command, so this quick hack just
makes it acceptable to do "git cmd --help" instead, and get the exact same

It may be hacky, but it's simple and does the trick.

Of course, this does not help if you use one of the non-builtin commands
without using the "git" helper. Ie you won't be getting a man-page just
because you do "git-rev-list --help". Don't expect us to be quite _that_

Signed-off-by: Linus Torvalds <>
Signed-off-by: Junio C Hamano <>
  • Loading branch information...
1 parent 6f4780f commit 1cd95087c331e17c44a8b62f0614d55e621dcfd4 Linus Torvalds committed with Junio C Hamano Apr 15, 2006
Showing with 6 additions and 0 deletions.
  1. +6 −0 git.c
6 git.c
@@ -413,6 +413,12 @@ static void handle_internal_command(int argc, const char **argv, char **envp)
int i;
+ /* Turn "git cmd --help" into "git help cmd" */
+ if (argc > 1 && !strcmp(argv[1], "--help")) {
+ argv[1] = argv[0];
+ argv[0] = cmd = "help";
+ }
for (i = 0; i < ARRAY_SIZE(commands); i++) {
struct cmd_struct *p = commands+i;
if (strcmp(p->cmd, cmd))

0 comments on commit 1cd9508

Please sign in to comment.