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