Massive commenting overhaul

Commented the bejeepers out of the files. Also, reorganized some
sections to be more coherent and flow better. Should be cool.