Re: [PATCH] doc: add a blank line around block delimiters

From

Junio C Hamano <gitster@pobox.com>

Date

Mar 10, 2025, 16:19 UTC

Message-ID

<xmqqsenk97uk.fsf@gitster.g>

In-Reply-To

<pull.1878.git.1741549511665.gitgitgadget@gmail.com>

"Jean-Noël Avila via GitGitGadget" <gitgitgadget@gmail.com> writes:

>     This patch is basically a mass-replace of occurrences of paragraphs
>     followed by a block delimiter.
>     
>     The issue arose with a Chinese translation where the length of the
>     paragraph turned out to be smaller than the original English and to just
>     fit the number of hyphens of the following block starter.

;-)

>     An a longer term, I'm wondering how converting all the asciidoc files to
>     the modern style (i.e. atx-style, with variable "=" characters in front
>     of the line) would be perceived by the community.