ssax-styled texinfo parser

Andy Wingo <[email protected]> Thu, 08 Jul 2004 18:28:14 +0100
Newsgroups gmane.lisp.scheme.ssax-sxml
Message-ID <1089307694.19379.38.camel@localhost>
Hey all,

I wasn't kidding before when I said SSAX opened my mind ;) Inspired by
it, I decided to write a functional texinfo parser that folds over its
content, and that produces SXML[0]. It worked out pretty well.

I'm using texinfo because it's easy to write and has great indexing
facilities. Also, it is ideal for documenting programming-related
domains. Now that it can be generated at runtime, as "stexinfo", the
documentation can be generated introspectively, as in [1].

Also, I have some code that renders the stexi as plain text (similar to
the info output), HTML[1], and in a GtkTextBuffer.

Just wanted to let people know. The code is in my guile-lib branch[2],
and will make it into the mainline (and thus into Debian at some point)
soon.

[0] Well, almost. Texinfo @-commands can have parsed arguments. Rather
than leave these arguments in with the content, I decided to put then in
a special % element (similar to @). There is a stexi->sxml transformer
exported by the module, but it's not optimal yet. It just changes the %
to `texinfo-arguments', but really it should give the arguments a
special prefix, because DTDs can only validate direct children.

[1] http://ambient.2y.net/wingo/software/

[2] See http://ambient.2y.net/wingo/software/arch/

Cheers,
-- 
Andy Wingo <[email protected]>
http://ambient.2y.net/wingo/


-------------------------------------------------------
This SF.Net email sponsored by Black Hat Briefings & Training.
Attend Black Hat Briefings & Training, Las Vegas July 24-29 - 
digital self defense, top technical experts, no vendor pitches, 
unmatched networking opportunities. Visit www.blackhat.com