From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 15 Dec 2023 21:01:28 GMT
Subject: Re: [PATCH] git-add.txt: add missing short option -A to synopsis
Message-ID: <xmqqjzpfkwnr.fsf@gitster.g>
In-Reply-To: <20231215204333.1253-1-ericsunshine@charter.net>

Eric Sunshine <ericsunshine@charter.net> writes:

> From: Eric Sunshine <sunshine@sunshineco.com>
>
> With one exception, the synopsis for `git add` consistently lists the
> short counterpart alongside the long-form of each option (for instance,
> "[--edit | -e]"). The exception is that -A is not mentioned alongside
> --all. Fix this inconsistency
>
> Reported-by: Benjamin Lehmann <ben.lehmann@gmail.com>
> Signed-off-by: Eric Sunshine <sunshine@sunshineco.com>
> ---

Thanks.

I dug the history just in case we deliberately wanted to leave this
out of the synopsis section, but the side branch leading to the
merge at 378335b3 (Merge branch 'jc/add-addremove', 2008-07-20) does
not say we wanted to discourage "-A" (and encourage "--all").  This
would be a welcome change.

Will queue.