Comments to many methods, mainly about exceptions.
ADD: one more comment
Some cleanup of this PR
Merge pull request #127 from JakeGinnivan/XmlCommentsUpdate

Xml comments update