Improved consistency of comments

- fixed typos
- consistent capitalization
- respect maximum line width of 120 characters
Currently dox does not ignore line breaks and creates a new paragraph for every line break so introducing line breaks in dox comment blocks is not a good idea.