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
DOC: Modify BSplineTransform comments.

Author: dr.tim.allman@gmail.com

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

cbc1aa4 STYLE: Ensure documentation \author tags are parsed
Merge topic 'EditDoxygen_BSplineTransform_1361210465'

b306610 DOC: Modify BSplineTransform comments.