From: WHS <wouters@cistron.nl>
  To  : ggi-develop@eskimo.com
  Date: Wed, 26 Aug 1998 05:04:24 +0200

Re: ggi man page & info [Re: kgicon troubles]

Steve Cheng wrote:
> 
> On Tue, 25 Aug 1998, Wouter Scholten wrote:
> 
> > Btw 2: What abput that man page for ggi? I don't give a toss about
> > dvi/ps/html etc. Programmers need man pages and nothing else (for
> > functions at least). Therefore I suggest scrapping sgml for the libggi
> > doc and putting it in the man page (or pages when it gets too big for
> > one page). You only need to know a few commands to make man pages so
> > it's easy to update man pages after changing something in the API.
> 
> SGMLtools 1.1.x uses DocBook (which is much better designed) and GGI
> documentation will later use that too.  I don't know if SGMLtools can
> generate manpages from DocBook though, but the spec explicitly has support
> for it.

If it can't or if it isn't supported REALLY soon (and then it must also
give good manpages), dump sgml for libggi. Josh Yelon mentioned a few
problems of ggi a while back, including docs. I have to agree there. Man
pages are essential. 

Wouter