From: Stephan Beyer Date: Sat, 07 Jun 2008 00:24:20 GMT Subject: [PATCH 1/2] git-commit.txt: Correct option alternatives Message-ID: <1212798261-26785-1-git-send-email-s-beyer@gmx.net> This patch fixes the SYNOPSIS in git-commit.txt: * --amend is not an alternative option to -c/-C/-F/-m * -m and -F are not alternative options to -c/-C, because you can reuse authorship from a commit (-c/-C) but change the message (-m/-F). Furthermore, for long-option consistency --author is changed to --author=. Signed-off-by: Stephan Beyer --- Hi, Dirk Süsserott's question about "minimal documentation patches" reminded me of an obscurity I came across in the SYNOPSIS section of the git-commit manual: [(-c | -C) | -F | -m | --amend] It suggests that you can't do something like git commit --amend -C deadf00 -m "Foo is dead. Long live foo." or that it might not be useful. The second hunk is: --author is advertised for historical reasons (I guess), but all the other long options with an argument are --long-opt=, e.g. --message= or --cleanup=. (Notice the equals sign.) Because parse_long_opt() accepts both, I changed this for consistency reasons. Regards, Stephan Documentation/git-commit.txt | 6 +++--- 1 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt index c3c9f5b..c734326 100644 --- a/Documentation/git-commit.txt +++ b/Documentation/git-commit.txt @@ -8,8 +8,8 @@ git-commit - Record changes to the repository SYNOPSIS -------- [verse] -'git-commit' [-a | --interactive] [-s] [-v] [-u] - [(-c | -C) | -F | -m | --amend] +'git-commit' [-a | --interactive] [-s] [-v] [-u] [--amend] + [(-c | -C) ] [-F | -m ] [--allow-empty] [--no-verify] [-e] [--author ] [--cleanup=] [--] [[-i | -o ]...] @@ -68,7 +68,7 @@ OPTIONS Take the commit message from the given file. Use '-' to read the message from the standard input. ---author :: +--author=:: Override the author name used in the commit. Use `A U Thor ` format. -- 1.5.5.1