Re: [PATCH v2] doc: fix asciidoc format compatibility in pretty-formats.adoc

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 20, 2025, 21:03 UTC
Message-ID: <xmqqwm6x904z.fsf@gitster.g>
In-Reply-To: <20250820203722.31268-1-jn.avila@free.fr>

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

Show 9 quoted lines

> The change is needed because Asciidoc.py and Asciidoctor
> do not process the '+' verbatim the same way. A span is
> detected when the format sign (here '+')is preceded by a
> non-word character. I haven't digged into the source,
> but it seems that '{nbsp}' is considered a non-word sign
> by Asciidoc.py, but not by Asciidoctor.
>
> Using the double '+' opens 'unconstrained' span,
> independent on the preceding character in both engines.

Thanks for explaining.

It is especially nice to see "independent on the preceding character in both engines", meaning that this fixes Asciidoctor while not breaking Asciidoc ;-)

Now, can you do give the explanation in the proposed commit log message, so that later people do not have to ask the same question while reading "git log -p" output?

Thanks.