On Thu, Aug 08, 2013 at 09:20:16AM +0200, Alan Barrett wrote: > On Wed, 07 Aug 2013, James K. Lowden wrote: > >If HTML is desired, there are a couple of options. I haven't used it, > >but troff2page sounds nice. > >http://www.ccs.neu.edu/home/dorai/troff2page/index.html#node_toc_start > >GNU troff also supports HTML output, but I haven't had great luck with > >it. > > For rendering man pages to plain text, HTML, or PDF, please consider > the BSD-licenced mandoc program (which, confusingly, is part of a > package called "mdocml"). See <http://mdocml.bsd.lv>. The HTML and > PDF output from mandoc is superior to the corresponding output from > groff, but mandoc is more fussy about errors in the input. > > --apb (Alan Barrett)
I concur. mandoc should be used if available, otherwise fall back to groff. However, as a first step, having pages generated by groff would be just fine. Hooking in another tool is easy once that's done.
