Martin Ågren <martin.agren@xxxxxxxxx> writes: > On Wed, 18 Jan 2023 at 17:23, Junio C Hamano <gitster@xxxxxxxxx> wrote: >> >> Are you comparing both roff output and html output, by the way? > > Yes, I'm trying to make sure all four of > > {asciidoc, asciidoctor} x {man, html} > > agree and look good. For the manpages, I use our doc-diff script. (In > this case, I wanted an empty asciidoc diff (HEAD^ HEAD) and a good > Asciidoctor diff (s/+//-ish).) For the html, it's a bit more manual > labour, switching between files in a browser and convincing myself > everything is good, visually. > > Luckily, once both tools agree on the manpages and they look good, in my > experience, the html is probably also ok. Wonderful. Thanks for your careful work, as always.