Remove unnecessary/wrong use of \a in comment.

\a is meant to refer to arguments. Links to class/function names are
automatic generated in doxygen.
Remove colon after @param @warning @deprecated

Added a missing @param.