[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: man pages for Subversion

From: Stefan Sperling <stsp_at_elego.de>
Date: Thu, 8 Aug 2013 09:37:04 +0200

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.
Received on 2013-08-08 09:37:43 CEST

This is an archived mail posted to the Subversion Dev mailing list.