Re: [PATCH] git-push.txt: document the behavior of --repo

From: Junio C Hamano <gitster@pobox.com>
Date: Jan 28, 2015, 20:12 UTC
Message-ID: <xmqqfvauhdfi.fsf@gitster.dls.corp.google.com>
In-Reply-To: <CAPig+cQCf+vKbZ5ydFSNmGCUvmCkQW-DEPhO1JAAap1VorhXsA@mail.gmail.com>

Eric Sunshine <sunshine@sunshineco.com> writes:

Show 11 quoted lines

>> +       This option is equivalent to the <repository> argument; the latter
>> +       wins if both are specified.
>
> To what does "latter" refer in this case? (I presume it means the
> standalone <repository> argument, though the text feels ambiguous.)
>
> Also, both the standalone argument and the right-hand-side of --repo=
> are spelled "<repository>", so there may be potential for confusion
> when talking about <repository> (despite the subsequent "argument").
> Perhaps qualifying it as "_standalone_ <repository> argument" might
> help.

I didn't find that "latter" too hard to understand (I admit that my reading stuttered there, though).

I do not think saying "standalone <repository> argument" there would help very much, because there is no mention of "standalone" around there. The earlier part of the sentence mentions "option" and "argument", so "the repository specified as an argument is used if both this option and an argument are given" or something?