[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: literate programming

From: Linas Vepstas
Subject: Re: literate programming
Date: Mon, 26 Jul 2004 08:06:28 -0500
User-agent: Mutt/1.5.4i

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?


pub  1024D/01045933 2001-02-01 Linas Vepstas (Labas!) <address@hidden>
PGP Key fingerprint = 8305 2521 6000 0B5E 8984  3F54 64A9 9A82 0104 5933

reply via email to

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