The flying docs

Completed a first draft of adding xml documentation to all public
methods. Yay, no more yellow in the build output.