Hacker News Reader

To me, this post is in the finest spirit of HN's reason for being. It is delightful to to see the endless colliding of important primitive and historic objects written well and become accessible to many. My mind reels with all these fantastic permutations of what is possible and made accessible, and I must constantly refresh and resort the "I want to know this one too" queue.

View on HN

I'm flattered. :)

As a long time fellow traveler in the land of Literate Programming, I must ask how you created the document---by hand or with tools and if tools, which ones?

That magic actually comes courtesy of [SnabbSwitch](https://github.com/SnabbCo/snabbswitch/wiki), latest project of the inimitable Luke Gorrie. Luke is also publishing SnabbSwitch semi-regularly as a [readable program](http://blog.lukego.com/blog/2012/10/24/readable-programs/).

Basically, you write markdown comments in the code and there is a Makefile that uses awk and sed to grab them out, cat some things together and pass it to an awesome LaTeX stylesheet written by Pete Kazmier. See: https://github.com/redline6561/cl-6502/tree/master/src/doc and the Makefile in the parent directory.

Reply on news.ycombinator.com