more docs
uniform the comment style.

Proper STYLEing and doxygen-ization will follow in
separate steps.