Re: Unbalanced closing paren in help of git commit

From: Junio C Hamano <gitster@pobox.com>
Date: Jul 8, 2024, 19:57 UTC
Message-ID: <xmqqcynnejwl.fsf@gitster.g>
In-Reply-To: <87o7792xgu.fsf@posteo.net>

Tomas Nordin <tomasn@posteo.net> writes:

> Hello List
>
> The second line of the help message for git commit looks like this:

This seems to have come from 00ea64ed (doc/git-commit: add documentation for fixup=[amend|reword] options, 2021-03-15), if "git blame" is to be trusted.

>     [--dry-run] [(-c | -C | --squash) <commit> | --fixup [(amend|reword):]<commit>)]

We can have --dry-run but we do not have to, we can have only one of

    "-c <commit>"
    "-C <commit>",
    "--squash <commit>",
    "--fixup amend:<commit>"
    "--fixup reword:<commit>", or
    "--fixup <commit>"

as they are mutually exclusive, but it is OK if we have none of them.

The last closing parenthesis after <commit> but before the closing square bracket is unwanted, I think, as you pointed out.