On Fri, Dec 15, 2023 at 4:01 PM Junio C Hamano <gitster@xxxxxxxxx> wrote: > Eric Sunshine <ericsunshine@xxxxxxxxxxx> writes: > > 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 > > 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. I also dug through the history for the same reason and, like you, did not find any indication that -A was omitted from the synopsis deliberately. I probably should have stated as much in the patch commentary.