STYLE: Ensure documentation \author tags are parsed

\author tags should come after the brief description and are terminated
by an empty line or another tag.

Also clean some whitespace in documentation.

Change-Id: I12346c1cdebbee5cb166025cad8702dc361bf106
Merge topic 'doc-author-fix'

cbc1aa4 STYLE: Ensure documentation \author tags are parsed