David Bakhash <ca
...@bu.edu> writes:
> this is really excellent.
used to the idea of getting excellent and accurate documentation at
the touch of a button, you'll never want to be without it...
This brings me to something I've been pondering about: As part of
(re-)writing documentation for MaiSQL (and several other packages),
I've started on some work of customizing DocBook to make it more
suitable for (Common) Lisp (i.e. stripping out useless C/Unix centric
stuff (synopsis-related) and introducing instead things of use to Lisp
developers), as well as some work on Norman Walsh' excellent DocBook
DSSSL StyleSheets, which produce nice HTML and printed output from the
DocBook source.
It might be useful to try to "standardize" some form of DocBook
customization, and write a couple of simple tools/framework stuff,
that would allow documentation written using this to be easily plugged
into Emacs for lookup (i.e. since all symbols will be marked up in the
documentation stuff anyway, it should be simple to produce the
symbol->URL mapping needed for something like Erik's hyperspec.el
while generating the HTML output).
If combined with some standardized defsystem stuff, this would make
for easily "pluggable" packages...
Anyone interested in this kind of stuff? (Beware: nothing of the
stuff imagined here is anywhere near alpha-stage, even design-wise,
and I probably won't have time to do something about it in the next
1-3 months. Just interested in opinions at the moment...)
Regs, Pierre.
--
Pierre Mai <p...@acm.org> PGP and GPG keys at your nearest Keyserver
"One smaller motivation which, in part, stems from altruism is Microsoft-
bashing." [Microsoft memo, see http://www.opensource.org/halloween1.html]
