Re: Template for GNOME man pages.

[Sander Vesik <Sander Vesik Sun COM>]

On Tue, 29 Oct 2002, Pat Costello wrote:

> John Fleck tapped out: 
> > 
> > I've been writing the libxml2 and libxslt man pages in DocBook, then
> > using the DB->man xslt stylesheet in docbook cvs to convert to the man
> > page for distribution.
> > 
> > see gnome-xml/doc/xmllint.xml and libxslt/doc/xsltproc.xml for the
> > DocBook markup, and contrib/xsl/db2man/db2man.xsl in DocBook cvs for the
> > stylesheet I use to convert it to a man page (thanks to Martijn van
> > Beers for the stylesheet).
> > 
> 
> When you say "convert it to a man page", what exactly do you mean? Do you mean 
> that the final output is nroff? If so, why not write the man page in nroff in 
> the first place? What's the aim of writing in one format (xml) if we have to 
> convert to another? 
> 

Solaris man supports sgml man pages so it might be that no use of *roff
(which at least imho is a really painful and outdated format that should
have died in the 90s the latest) is actually needed.

> Pat
> 

	Sander

	There are voices in the street,
	And the sound of running feet,
	And they whisper the word --
	Revolution!