[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):
> > 
> >
> 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?

Aubrey Jaffer has got an SLIB based texinfo generator that works
really well:

It's very similar to doxygen. 


reply via email to

[Prev in Thread] Current Thread [Next in Thread]