# git commit synopsis typo?

5 messages from 2010-11-29 to 2010-12-01. Participants: Joey Hess, Junio C Hamano, jari.aalto@cante.net, Jonathan Nieder.
Thread: https://gitlist.dev/t/25871

## Joey Hess, 2010-11-29 17:37

Subject: git commit synopsis typo?
Message-ID: <20101129173758.GA2279@gnu.kitenet.net>
URL: https://gitlist.dev/e/20101129173758.GA2279%40gnu.kitenet.net

```
Shouldn't the -i and -o options be listed before the -- option?

       git commit [-a | --interactive] [-s] [-v] [-u<mode>] [--amend] [--dry-run]
                  [(-c | -C) <commit>] [-F <file> | -m <msg>] [--reset-author]
                  [--allow-empty] [--allow-empty-message] [--no-verify] [-e] [--author=<author>]
                  [--date=<date>] [--cleanup=<mode>] [--status | --no-status] [--]
                  [[-i | -o ]<file>...]

-- 
see shy jo

```

## Junio C Hamano, 2010-11-29 20:24

Subject: Re: git commit synopsis typo?
Message-ID: <7vlj4b280b.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7vlj4b280b.fsf%40alter.siamese.dyndns.org
In-Reply-To: <20101129173758.GA2279@gnu.kitenet.net>

```
Joey Hess <joey@kitenet.net> writes:

> Shouldn't the -i and -o options be listed before the -- option?
>
>        git commit [-a | --interactive] [-s] [-v] [-u<mode>] [--amend] [--dry-run]
>                   [(-c | -C) <commit>] [-F <file> | -m <msg>] [--reset-author]
>                   [--allow-empty] [--allow-empty-message] [--no-verify] [-e] [--author=<author>]
>                   [--date=<date>] [--cleanup=<mode>] [--status | --no-status] [--]
>                   [[-i | -o ]<file>...]

Yes, please make it so ;-)

Thanks.

```

## jari.aalto@cante.net, 2010-12-01 14:51

Subject: [PATCH] git-commit.txt: (synopsis): move -i and -o before "--"
Message-ID: <74d884bbd76bf090472b123f8053f095cda523f9.1291215072.git.jari.aalto@cante.net>
URL: https://gitlist.dev/e/74d884bbd76bf090472b123f8053f095cda523f9.1291215072.git.jari.aalto%40cante.net
In-Reply-To: <7vlj4b280b.fsf@alter.siamese.dyndns.org>

```
From: Jari Aalto <jari.aalto@cante.net>


Signed-off-by: Jari Aalto <jari.aalto@cante.net>
---
 Documentation/git-commit.txt |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt
index 42fb1f5..46ddc80 100644
--- a/Documentation/git-commit.txt
+++ b/Documentation/git-commit.txt
@@ -11,8 +11,8 @@ SYNOPSIS
 'git commit' [-a | --interactive] [-s] [-v] [-u<mode>] [--amend] [--dry-run]
 	   [(-c | -C) <commit>] [-F <file> | -m <msg>] [--reset-author]
 	   [--allow-empty] [--allow-empty-message] [--no-verify] [-e] [--author=<author>]
-	   [--date=<date>] [--cleanup=<mode>] [--status | --no-status] [--]
-	   [[-i | -o ]<file>...]
+	   [--date=<date>] [--cleanup=<mode>] [--status | --no-status]
+	   [-i | -o ] [--] [<file>...]
 
 DESCRIPTION
 -----------
-- 
1.7.2.3

```

## Jonathan Nieder, 2010-12-01 16:39

Subject: Re: [PATCH] git-commit.txt: (synopsis): move -i and -o before "--"
Message-ID: <20101201163930.GE26120@burratino>
URL: https://gitlist.dev/e/20101201163930.GE26120%40burratino
In-Reply-To: <74d884bbd76bf090472b123f8053f095cda523f9.1291215072.git.jari.aalto@cante.net>

```
jari.aalto@cante.net wrote:

> From: Jari Aalto <jari.aalto@cante.net>

"The -i and -o options cannot be used after --, so do not get the reader's
hopes up by suggesting they can.

Reported-by: Joey Hess <joey@kitenet.net>"

> Signed-off-by: Jari Aalto <jari.aalto@cante.net>

Thanks.

[...]
> --- a/Documentation/git-commit.txt
> +++ b/Documentation/git-commit.txt
> @@ -11,8 +11,8 @@ SYNOPSIS
>  'git commit' [-a | --interactive] [-s] [-v] [-u<mode>] [--amend] [--dry-run]
>  	   [(-c | -C) <commit>] [-F <file> | -m <msg>] [--reset-author]
>  	   [--allow-empty] [--allow-empty-message] [--no-verify] [-e] [--author=<author>]
> -	   [--date=<date>] [--cleanup=<mode>] [--status | --no-status] [--]
> -	   [[-i | -o ]<file>...]
> +	   [--date=<date>] [--cleanup=<mode>] [--status | --no-status]
> +	   [-i | -o ] [--] [<file>...]

While at it, shouldn't we get rid of the extra space after "-o"?

```

## Junio C Hamano, 2010-12-01 19:01

Subject: Re: [PATCH] git-commit.txt: (synopsis): move -i and -o before "--"
Message-ID: <7v4oaxwc4b.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7v4oaxwc4b.fsf%40alter.siamese.dyndns.org
In-Reply-To: <20101201163930.GE26120@burratino>

```
Jonathan Nieder <jrnieder@gmail.com> writes:

> jari.aalto@cante.net wrote:
>
>> From: Jari Aalto <jari.aalto@cante.net>
>
> "The -i and -o options cannot be used after --, so do not get the reader's
> hopes up by suggesting they can.
>
> Reported-by: Joey Hess <joey@kitenet.net>"
> ...
> While at it, shouldn't we get rid of the extra space after "-o"?

Will do all of these at my end.

Thanks for an excellent coach to other contributors, as always.

```