Re: writing man pages or texinfo documentation
Date: Tue, 25 May 1999 22:44:01 +0100
From: Adam Sampson <azz@josstix.demon.co.uk>
On Tue, May 25, 1999 at 10:25:30AM +0200, Mark Kettenis wrote:
> A good manual, divided in chapters and sections, with an index and cross
> references is a much better way to structure the information in a, for the
> user, logical way.
Info isn't exactly ideal. Why not use a different solution, as we're
starting over?
I'm not interested to participate in a traditional ``Info sucks''
flamewar, so if people are continuing this, please do not CC: me.
Please realize that the documentation is written in texinfo, not
directly in the Info format. Texinfo is a flexible markup langauge
based on TeX. In principle it can be converted into anything you
want, obviously into the Info format (using makeinfo), but also
printed output (using TeX) and into HTML (using texi2html). I believe
there is even a converter to convert texinfo to the Docbook SGML DTD.
The basic tools for handling texinfo are stable, free and widely
available. Moreover, it is the GNU standard. Let's keep writing our
manuals in texinfo.
Reply to: