From: Junio C Hamano <gitster@pobox.com>
Date: Tue, 13 Jan 2026 12:54:23 GMT
Subject: Re: [PATCH 1/1] doc: git-bisect: convert to new doc format
Message-ID: <xmqqqzrtllkw.fsf@gitster.g>
In-Reply-To: <4705928.LvFx2qVVIh@piment-oiseau>

Jean-Noël AVILA <jn.avila@free.fr> writes:

>>  ------------
>> -$ git bisect run my_script arguments
>> +$ git bisect run <my_script> <arguments>
>>  ------------
>
> Here, if you want to use to use the synopsis formatting, you may replace the 
> verbatim block with a [synopsis] one:
>
> [synopsis]
> $ git bisect run <my_script> <arguments>
>

Can you add a bit to "if you _want_ to use" above?  What's the
pros-and-cons of doing so or leaving it as the way it is written in
the patch?  That would help people on the same page when they decide
if they want to use the [synopsis], preferring over the verbatim
block.

>
> Otherwise, LGTM
>
> Thanks.

Thanks for a review.