Re: [PATCH/resend] Doc: git-push: Specify the default mode in the description

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Mon, Nov 8, 2010 at 9:48 PM, Junio C Hamano <gitster@xxxxxxxxx> wrote:
> Santi Béjar <santi@xxxxxxxxxxx> writes:
>
>> Signed-off-by: Santi Béjar <santi@xxxxxxxxxxx>
>> ---
>> Hi *,
>>
>>   just resend a patch that maybe was missed inside this thread:
>
> No, I didn't miss it.
>
> The new text says 'push "matching" branches' before explaining what it is,
> only vaguely refers the reader to the next section by "see below" without
> telling which part of below the reader should look at.  In other words, it
> wastes two lines without adding two lines worth of additional information.
>
> Saying "look for string 'default' below" might be an improvement ;-), but
> then the reader can do that without being told to do so themselves, so...

At least with the new text the reader will know what to look for. She
has to look for "matching" and not the generic "default". BTW, I'll
send another patch with the explanation of matching, but it just
repeats what is written in the <refspec> option...

Another option would be to add "see the <refspec> option below",
although is is already implicit as the paragraph begins with "if no
explicit refspec".

Santi
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]