From: Jean-Noël Avila <jn.avila@free.fr>
Date: Wed, 02 Apr 2025 06:49:40 GMT
Subject: Re: [PATCH] doc: fix asciidoctor synopsis processing of triple-dots
Message-ID: <dfe21538-e70c-4d19-a90f-2c3cf8d3d377@free.fr>
In-Reply-To: <xmqqecyba6zz.fsf@gitster.g>

Le 01/04/2025 à 23:48, Junio C Hamano a écrit :
> Jean-Noël Avila <jn.avila@free.fr> writes:
> 
>> The processing of triple dot notation is tricky because it can be
>> mis-interpreted as an ellipsis.
>>
>> Another issue is that the formatting of synopsis paragraph in
>> Asciidoctor spits out another asciidoc formatted text where verbatim
>> text formatted with backquotes must have surrounding separators in
>> order to be properly detected, even if they are sticking to another
>> text.
>>
>> The special processing of the ellipsis is now complete and takes into
>> account the case of `git-mv <source>... <dest>`
>>
>> Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
>> ---
>>  Documentation/asciidoctor-extensions.rb.in | 8 +++++---
>>  Documentation/diff-generate-patch.adoc     | 2 +-
>>  2 files changed, 6 insertions(+), 4 deletions(-)
> 
> The .gsub() changes seem to interact with your "doc: fix synopsis
> analysis logic" in the series that updates reset/mv/rm documentation
> mark-up.
> 
> 

I will incorporate this patch in the reset/mv/rm series.