In article <email@example.com>,
Olin Shivers <firstname.lastname@example.org> 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.
Cygnus Solutions email@example.com http://www.cygnus.com/~bothner