Re: [Yaml-core] Spec Formats?

[Neil W. <neilw@ActiveState.com>]

Hi all,

I'm strongly leaning towards GNU Info after reading to documentation for
'makeinfo'. Here are the formats I could find that it outputs:

   a) info
      $ makeinfo yaml.texi
   b) plain text
      $ makeinfo --text yaml.texi > yaml.txt
   c) HTML
      $ makeinfo --html yaml.texi
   d) DocBook
      $ makeinfo --docbook yaml.texi
   e) [La]TeX
      $ 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:

----8<----
\input texinfo
@setfilename yaml.info
@settitle Draft YAML Specification 1.0

@node Top, Copyright, (dir), (dir)

This is the Draft YAML Specification.

@menu
* Copyright::
@end menu

@node Copyright, (dir), Top, Top
@section Copyright

The YAML specification is Copyright 2002 by Clark Evans
@email{clark@@evans.com}.

You may foo bar baz.
---->8----

Later,
Neil

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...