I'm strongly leaning towards GNU Info after reading to documentation for
'makeinfo'. Here are the formats I could find that it outputs:
$ makeinfo yaml.texi
b) plain text
$ makeinfo --text yaml.texi > yaml.txt
$ makeinfo --html yaml.texi
$ makeinfo --docbook yaml.texi
$ tex yaml.texi # OR
# texi2dvi yaml.texi
f) XML (TexinfoML, whatever that is)
$ makeinfo --xml yaml.texi
I'm pretty much sold on it. Truth be told, I haven't check whether you can
get this stuff on Windows (I know it works in Cygwin). I imagine you can,
since it's just a simplified TeX.
Here's an example:
@settitle Draft YAML Specification 1.0
@node Top, Copyright, (dir), (dir)
This is the Draft YAML Specification.
@node Copyright, (dir), Top, Top
The YAML specification is Copyright 2002 by Clark Evans
You may foo bar baz.
Oren Ben-Kiki [30/03/02 18:12 -0500]:
> FWIW, the RELAX NG spec is written in DocBook. I took a glance at the
> sources. A bit verbose (<listentry>, <para> and the like) but otherwise
> seems rather nice. The links are here:
> http://www.oasis-open.org/committees/relax-ng/#documents (I haven't tried to
> download the production tools). BTW, whiloe my laptop is a dual-boot
> Linux/Windows, my home computer is Windows-only... does Info/DocBook work on
> Windows? I did my thesis using LaTex and I know it does, although it wasn't
> somewhat of a pain...