[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: literate programming
|
From: |
Nic Ferrier |
|
Subject: |
Re: literate programming |
|
Date: |
26 Jul 2004 14:23:56 +0100 |
address@hidden (Linas Vepstas) writes:
> On Sun, Jul 25, 2004 at 06:59:54PM +0100, Andy Wingo was heard to remark:
> > Hey folks,
> >
> > I wrote an article recently about literate programming in guile. The URL
> > is here (sorry, it's a bit long):
> >
> > http://ambient.2y.net/wingo/archives/2004/07/25/literate-programming-with-guile-lib
>
> What happens if one fails to document each and every variable?
>
> How do you tell apart other usages of "..." ?
>
> I use something similar to eguile, it embeds scheme into html,
> <html><body>Howdy <?scm (do-stuff "<h1>more markup</h1>") ?></body></html>
> Sounds incompatbile with the texinfo module.
>
> I'd like to see documentation set off with ;; (double semicolon, to
> distinguish from single semicolon). Or maybe ;! or ;-- or some other
> unique setoff.
>
> And what about "doxygen"? It works really really well for a half-dozen
> other languages and styles ... can it be extended for guile?
>
> http://www.stack.nl/~dimitri/doxygen/
Aubrey Jaffer has got an SLIB based texinfo generator that works
really well:
http://swissnet.ai.mit.edu/~jaffer/slib_4.html#SEC86
It's very similar to doxygen.
Nic
http://www.tapsellferrier.co.uk