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.
Martin
