Re: [PATCH 1/1] doc: git-bisect: convert to new doc format

From: Junio C Hamano <gitster@pobox.com>
Date: Jan 13, 2026, 12:54 UTC
Message-ID: <xmqqqzrtllkw.fsf@gitster.g>
In-Reply-To: <4705928.LvFx2qVVIh@piment-oiseau>

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

Show 11 quoted lines

>>  ------------
>> -$ 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.