Comment more of the code more thoroughly

[dabrahams]

Unless this codebase is going to die with the Boost transition to Git, it will need many more very clear comments so that someone else can pick it up and use it later