Docblock Fixes

Let's ensure all methods have docblocks, that all short descriptions end in a full stop, and that all the comments are correctly wrapped to 80 character line lengths (only 2 of them weren't for whatever reason).