News for hackers. Stuff that matters.
Re:Zed Shaw on Modern Literate Programming by jrockway on Sunday April 27, 2008 @01:03AM (#174681)
I'm not sure why he thinks literate programming source code is hard to parse. I would just implement it like this; normal text is normal text, program text is indented two spaces. Example:

This is a super-fun algorithm. It is a function of super-fun-arguments, a list.

  (defun super-fun-algorithm (&rest super-fun-arguments)
We start by parsing the super-fun-arguments into lists of foobars. See page 1234 for the parse-into-foobars utility function.

    (let ((foobars (parse-into-foobars super-fun-arguments)))
OK, I'm bored now. But this is only tedious because I'm writing about irrelevant details (we all know what defun does, after all).

There are no comments on this comment yet.