From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 03 May 2023 06:09:31 GMT
Subject: Re: [PATCH 1/2] doc: git-checkout: trivial callout cleanup
Message-ID: <xmqqpm7ivtd0.fsf@gitster.g>
In-Reply-To: <20230502101854.GA1180695@coredump.intra.peff.net>

Jeff King <peff@peff.net> writes:

>> > Using just a blank line between the code block and the call-out list
>> > (instead of the "+") works for asciidoc (it is happy to keep the two
>> > together) but not asciidoctor (it ends the outer ordered list before
>> > starting the callout list).
>> ...
>  $ git checkout hello.c            <3>
>  ------------
> -+
> +
>  <1> switch branch
>  <2> take a file out of another commit
>  <3> restore `hello.c` from the index
>
> which asciidoc renders the same, but asciidoctor is not.

Yet another random annoying differences that explains why we wrote
it that way in the first place X-<.  If it has been removed to make
it not to matter, that was lucky of us ;-)

Thanks.