Re: Literate Programming

[Mario Lang <mlang teleweb at>]

"John J. Boyer" <director chpi org> writes:

> I'm coordinating the development of a Braille Translator for Gnome. 
> Literate programming may be used in the project. If some of you on this 
> list have had experience with it I would like to hear how well it worked 
> for you.

Well, literate programming is only good if you
like to write comments, and are good at it.

It's basicly nothing else than the original strategy inside out.
So you no longer write comments in between code
but you write code between comments.

I've done this the first time I used Haskell, and it
worked out fine, but I think it really depends on the problem
you are facing.  If it's a complicated topic it may be good
to use literate programming to make it easier for
others to understand your code, but you have to ensure
that your comments match the code, as always :)

-- 
CYa,
  Mario