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 e350b999 for ; Thu, 7 Jun 2018 10:24:22 -0500 (EST) Received: from www.stare.cz (localhost [127.0.0.1]) by www.stare.cz (OpenSMTPD) with ESMTP id 9a745a67 for ; Thu, 7 Jun 2018 17:24:21 +0200 (CEST) Date: Thu, 7 Jun 2018 17:24:20 +0200 From: Jan Stary To: discuss@mdocml.bsd.lv Subject: Re: a few -Thtml nits Message-ID: <20180607152419.GA74415@www.stare.cz> Mail-Followup-To: discuss@mdocml.bsd.lv References: <20180607145947.GA28980@www.stare.cz> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20180607145947.GA28980@www.stare.cz> User-Agent: Mutt/1.7.1 (2016-10-04) On Jun 07 16:59:48, hans@stare.cz wrote: > Hi Ingo, > > firts of all, many thanks for the continuous improvements of mandoc. > > I am in the process of converting the rtptools' html manpages > to be generated from the actual manpages with mandoc -Thtml. > > https://github.com/janstary/rtptools/commits/webpage > ./configure && make clean html > > Mostly, mandoc -Thtml -O style,man works very well. > However, there are a few nits. > > 1. The w3c validator finds what it considers fatal errors in the output: > https://validator.w3.org/nu/?doc=http%3A%2F%2Fbiblio.stare.cz%2Frtptools%2Frtpdump.1.html > The problem seems to be that the generated html manpage contains, > as a long html comment, the obligate license statement (itself a comment > in the mdoc source) which is long enough to push the > _after_ the first 1024 bytes, which the validator considers a problem. > > 2. I can link to http://biblio.stare.cz/rtptools/rtpdump.1.html#F > - would it be an improvement if mandoc -Thtml created such links > in the SYNOPIS, or would it be too much clutter in the one line? > > 3. The AUTHORS get rendered fine; could the .An John Doe Mt ... > be rendered in the -Thtml output as a "mailto:", or is it > a special case not worth the complication? 4. Why the empty
 
 
between the individual options? Jan -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv