From: Steve Cheng <elmert@ipoline.com>
  To  : ggi-develop@eskimo.com
  Date: Sun, 30 Aug 1998 12:27:46 -0400 (EDT)

Re: ggi man page & info

On Tue, 25 Aug 1998, Adrian Ratnapala wrote:

> > write some simple sgml2man / html2man / latex2man converter in, let's say,
> > perl?
> The problem is that linuxdoc documents and man pages have quite different
> structures.

Yes, Linuxdoc is a badly designed SGML application.

> Personally I think man pages are well suited to documentation that is
> automatically generated form comments in the source, while SGML is better
> for "hand written docs".

I already have a DocBook-to-man converter working (it will take each
RefEntry and write manpage output).  I'll release it once I get libggi.sgml
into DocBook format and tested it enough.

> docs which look like man pages, this will be the referance manual.  The
> rest of the docs I will write in in SGML, and not bother converting to man
> pages (since man isn't suitable for that kind of documentation).

Take a look at DocBook -- it's much better than Linuxdoc for technical
documentation.

--
Steve Cheng

email: steve@ggi-project.org
www: <http://shell.ipoline.com/~elmert/>;