git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] git-add.txt: add missing short option -A to synopsis

From
Junio C Hamano <gitster@pobox.com>
Date
Dec 15, 2023, 21:01 UTC
Message-ID
<xmqqjzpfkwnr.fsf@gitster.g>
In-Reply-To
<20231215204333.1253-1-ericsunshine@charter.net>
Eric Sunshine <ericsunshine@charter.net> writes:
Show 10 quoted lines
> 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.
Previous: Eric SunshineNext: Eric Sunshine
Message 3 of 5 in “Bug | Documentation | git add -all | Synopsis has minor mistake”
  1. Benjamin LehmannDec 15, 2023
  2. git-add.txt: add missing short option -A to synopsisEric Sunshine, Dec 15, 2023
  3. Junio C HamanoDec 15, 2023
  4. Eric SunshineDec 15, 2023
  5. Eric SunshineDec 15, 2023

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.