Subject: Re: Using docbook for man pages

Re: Using docbook for man pages

From: Daniel Stenberg <daniel_at_haxx.se>
Date: Tue, 2 Dec 2008 13:01:47 +0100 (CET)

On Tue, 2 Dec 2008, Gregor Jasny wrote:

> For one of my c-ares changeset, I need to write a manual page. I've noticed
> that all the manpages are written in directly in roff. Have you ever
> considered using docbook/sgml for authoring and convert it to roff at
> install time?

Well, I'd say there are at least two reasons:

- ares came with these man pages already in nroff format

- I have no problems with nroff as a source format. Thus converting to
   something else would just be work for me with no obvious extra benefit.

What would you say are the biggest gains we'd get by changing source format?
I'm not particularly against it, I'm just curious.

-- 
  / daniel.haxx.se
Received on 2008-12-02