Re: [PATCH] Documentation: render dash correctly

From: Martin Ågren <martin.agren@gmail.com>
Date: Jan 23, 2023, 08:19 UTC
Message-ID: <CAN0heSo6poJMNSmJ2Vwy2ecrW3YRc0E5VYLH22fXUgnqfx_TAA@mail.gmail.com>
In-Reply-To: <xmqqcz76qizp.fsf@gitster.g>

On Sun, 22 Jan 2023 at 23:55, Junio C Hamano <gitster@pobox.com> wrote:

Show 12 quoted lines

>
> Andrei Rybak <rybak.a.v@gmail.com> writes:
>
> > Three hyphens are rendered verbatim in documentation, so "--" has to be
> > used to produce a dash.
>
> Sad but true.  I suspect folks with TeX background were so
> accustomed to type three dashes to obtain em dash, but with AsciiDoc
> (and asciidoctor), sadly, two dashes is a way to ask for em dash.
>
> The changes in your patch look all reasonable to me at the source
> level; I didn't do Documentation/doc-diff to verify, though.

doc-diff looks good.

I suspect these were identified by greping for " --- ", spaces included. We seem to have some "---" that aren't surrounded by spaces. They're perhaps a bit more tedious to find, but I see there are two in gitformat-signature.txt and technical/rerere.txt. Maybe it would be worthwhile addressing them too in this patch.

Martin