From: Junio C Hamano <gitster@pobox.com>
Date: Sat, 07 Jun 2008 21:05:24 GMT
Subject: Re: [PATCH 2/2] git-commit.txt: Add missing long/short options
Message-ID: <7vy75hlzvv.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <1212798261-26785-2-git-send-email-s-beyer@gmx.net>

Stephan Beyer <s-beyer@gmx.net> writes:

> Furthmore, use
> 	short option::
> 	long option::
> instead of
> 	short option|long option::
> and split the "-c or -C <commit>" item into two separate items.

> ... 
> --q|--quiet::
> +-q::
> +--quiet::

While this may result in easier-to-read output, there are tons of other
pages that follow the current style.  I'd prefer:

 (1) a patch without "a|b\n" => "a::\nb::" for only git-commit.txt and

 (2) a patch that is "a|b\n" => "a::\nb::" for everybody but without any
     other changes.