In article <qijr9whsrj1.fsf@lambda.ai.mit.edu>,
Olin Shivers <shivers@lambda.ai.mit.edu> wrote:
>So perhaps the manual ought to be written in SGML, and then translated to
>various downstream forms, like LaTeX, HTML, info, etc. I believe this is what
>other systems like Linux and FreeBSD do.
I think that makes sense. But note the SGML is not a really a format,
it is a family of formats, of which html, Docbook, and the old linuxdoc
are specific instances (DTDs). I specifically recommend using the
"docbook" DTD. Many projects are using Docbook or migrating to it,
including Cygnus, O'Reilly, Gnome, and the Linux Documentation Project.
Some useful links: http://www.gnome.org/devel/docs.shtml.
--
--Per Bothner
Cygnus Solutions bothner@cygnus.com http://www.cygnus.com/~bothner
|