This is based on Don Knuth's Literate Programming: http://en.wikipedia.org/wiki/Literate_programming - but applied to build scripts.

(Readme is docs + executable)