Documentation fix: add missing parameter name.
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.
Merge pull request #3323 from timothyqiu/docfix

Documentation fixes