I just stumbled upon docco, the quick-and-dirty, hundred-line-long, literate-programming-style documentation generator. I really like the concept of having the documentation on the left side and the implementation code on the right side.
The following example is an implementation of the gnome sort algorithm in python:
There are ports to other languages as well: