For the LTSP5 package, we switched our manpage sources from .xml to .md and we started using go-md2man. After Debian Buster was released and its man pages went online, we noticed a problem.
The man pages generated by go-md2man
display fine when viewed under man
. But when distributions use mandoc to publish them as .html pages online, a lot of empty lines are included in the html output, around the markdown code
blocks (and I think elsewhere too).
As an example, see our lts.conf man page, as produced by go-md2man and then published by Debian's mandoc:
https://manpages.debian.org/unstable/ltsp-server/lts.conf.5.en.html
Search for the following line, and see how many empty lines are around it:
FSTAB_1="server:/home /home nfs defaults,nolock 0 0"
Our previous lts.conf manpage, that wasn't using go-md2man, displays a lot less empty lines:
https://manpages.debian.org/unstable/ltsp-docs/lts.conf.5.en.html
Ronn
also manages to convert our new markdown-based man pages without extra empty lines, so I believe it's an issue with go-md2man. Thanks!