Disable warning on missing XML comments, fix badly formed comments

Since there are quite a few public types are that missing comments, I've disabled [CS1591](http://msdn.microsoft.com/en-us/library/zk18c1w9.aspx).

There were also two invalid comments that are fixed.

If you want to leave CS1591 active, let me know and I'll resubmit separate PRs.