On Sun, 22 Jan 2023 at 23:55, Junio C Hamano <gitster@xxxxxxxxx> wrote: > > Andrei Rybak <rybak.a.v@xxxxxxxxx> 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