mandoc & perl documentation

["Pali Rohár" <pali.rohar@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 1341 bytes --]

Hello!

In perl world is documentation for perl modules or perl scripts writing
in the POD format. Build process for perl scripts/modules then convert
POD documentation into manpages and install it into standard system
location.

I looked at Debian manpages which uses mandoc for converting man pages
to HTML and basically documentation for perl modules is not good.

For example this is HTMLized manpage for Email::Address::XS perl module:
https://manpages.debian.org/Email::Address::XS

There is also converting tool which formats POD documentation directly
into HTML output. And for Email::Address::XS module is looks like:
https://metacpan.org/pod/Email::Address::XS

So, I would like to ask, how can be HTML output generated from perl
manpages improved (process: POD --> mandoc --> HTML), so documentation
would be more close to the native HTML output (process: POD --> HTML)?

I understand that something like syntax highlighting is not possible,
but if you look at differences, in HTML output from mandoc are broken
vertical spaces (some are totally missing) or missing all different font
families.

If problem is in POD --> manpage converter (Pod::Man module), I can look
at it. But at the first I would need to know what mandoc is able to
process and what not.

-- 
Pali Rohár
pali.rohar@gmail.com

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 195 bytes --]