From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mx.stare.cz (mx.stare.cz [79.98.77.229]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id b8175e8c for ; Thu, 11 Oct 2018 03:54:31 -0500 (EST) Received: from www.stare.cz (localhost [127.0.0.1]) by www.stare.cz (OpenSMTPD) with ESMTP id 7b2f2d72 for ; Thu, 11 Oct 2018 10:54:28 +0200 (CEST) Date: Thu, 11 Oct 2018 10:54:28 +0200 From: Jan Stary To: discuss@mandoc.bsd.lv Subject: Re: mandoc & perl documentation Message-ID: <20181011085427.GA66036@www.stare.cz> References: <20180913151226.oaon3nvlvgcqioau@pali> <20181011075247.2jo4of7bkpvhkekm@pali> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20181011075247.2jo4of7bkpvhkekm@pali> User-Agent: Mutt/1.7.1 (2016-10-04) On Oct 11 09:52:47, pali.rohar@gmail.com wrote: > On Thursday 13 September 2018 17:12:26 Pali Rohár wrote: > > 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 You might want to try http://mandoc.bsd.lv/pod2mdoc/ Jan -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv