Problem
-------

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

- empty paragraph passed to '@remarks' command
- parameter 'is_drop' not found in the function declaration
- unknown parameters
- '@return' for functions returning void

Change
------

- fixed doc-comments

RB: 23968