JSDoc review

Just another file by file consistency review, making sure all blocks are
formatted the same way, that @ tags all follow the description, no
superfluous private blocks, valid @type and @default declarations,
indentation, sentences on separate lines wrapped at 80 columns, no
trailing double-spaces after sentences.
Merge pull request #1370 from kriskowal/jsdoc-review

JSDoc review