From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id cd8128ad for ; Thu, 13 Sep 2018 10:12:32 -0500 (EST) Received: by mail-wr1-f48.google.com with SMTP id v17-v6so6240450wrr.9 for ; Thu, 13 Sep 2018 08:12:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:subject:message-id:mime-version:content-disposition :user-agent; bh=Wou6cpv3gxDMkY4NngQyAeDjYXxgEbdglxXFCKNWiwM=; b=TAJNY78d/tGiRJyYOFD7kswJnf+sKKt8qUIoPc8dNLe3qTPbO5MnchtChp1mR5GjW9 oDte1s4AddRXqpEUCKIyAAQhU3OAOc+DOGajogf5Y45Gh2h3XOijq6jcmv9FdJfQIYFW MzGSCwiqBtkJ9Kkx6C9a43qpCI0a752gukQ7ZG68DPb+y0kClHkyQ/drfVr+3YKJv0OF Dy6mGeePA92Y6bBNR2hfv2HCHDpltP1pX6qaGTFez59Hr1Ej45CIVH/xS+Sr+qVsO3WV ymJZJEYKUyVB/PDmqCcFejbHEw6yqaFSoIScM2qhKgxNGXume8K9hS7mhqKoKMyrzbm4 Dyuw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:subject:message-id:mime-version :content-disposition:user-agent; bh=Wou6cpv3gxDMkY4NngQyAeDjYXxgEbdglxXFCKNWiwM=; b=KUWEI/czu4BQM0QZehC0I3rI2us8/zMEfE+VaxkZkz+M+kQOc+VPUDZRjh+Xg+xTDN E+2LSkTqv5rDQL8qoAerkJjYfFPdVjGgf1SEtPo06gqDcpPRVd6u7aQCUsOKtTexeVlQ OPSfLf5liZ5JG8uwYLqsrN/6E6eaXHpOOVmz0Kxi0blRSt6sW16dlbm2iGSDZ5Oo8l5X d4wdB83D8wtBssQUYLgzvv245VKZirTHgEj3npyZv0kJOh4uokg69jxTRLEQzgUI6RyI UgSbbfX2rZi1hB/hS8IMWGJ19c/8Cm2fcSnj5p484T5Cw5ZUiRjBZHzrsI+3m4yoWyQQ Jogg== X-Gm-Message-State: APzg51Crq5e7qakT31RquIDYcv/y4smr2TP6g6HRdYqDf+wMEElxkC8t sbsAX5zqBFL6uD3YiOIkvWIvDgth X-Google-Smtp-Source: ANB0VdZ13kpm7h+hx1AP2g6Xp7JiZcjW2lLeEeVD4wi2hfyVxO5uGkSaCKk5/YNLg6/qce6NNwGbeQ== X-Received: by 2002:a1c:1a49:: with SMTP id a70-v6mr5791035wma.91.1536851548078; Thu, 13 Sep 2018 08:12:28 -0700 (PDT) Received: from pali ([2a02:2b88:2:1::5cc6:2f]) by smtp.gmail.com with ESMTPSA id k35-v6sm9900182wrc.14.2018.09.13.08.12.26 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 13 Sep 2018 08:12:26 -0700 (PDT) Date: Thu, 13 Sep 2018 17:12:26 +0200 From: Pali =?utf-8?B?Um9ow6Fy?= To: discuss@mandoc.bsd.lv Subject: mandoc & perl documentation Message-ID: <20180913151226.oaon3nvlvgcqioau@pali> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="5yrqzb272ia7zrzk" Content-Disposition: inline User-Agent: NeoMutt/20170113 (1.7.2) --5yrqzb272ia7zrzk Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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. --=20 Pali Roh=C3=A1r pali.rohar@gmail.com --5yrqzb272ia7zrzk Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iF0EABECAB0WIQS4VrIQdKium2krgIWL8Mk9A+RDUgUCW5p+WAAKCRCL8Mk9A+RD Ur3kAJ9o8HG2IO6GDxq/iaWuEGMkQ/JwRQCfTVTHcDQ3iICQiGJEA8yYgjZyUWE= =A360 -----END PGP SIGNATURE----- --5yrqzb272ia7zrzk-- -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv