Problem
-------

building with clang and CMAKE_CXX_FLAGS="-Wdocumentation" reports:

- unknown parameters
- '@return' for functions returning void

Change
------

- fixed doc-comments

RB: 23969