Problem
=======

building with clang and -Wdocumentation reports

- @param documented not found
- @return documented for function not returning anything

Change
======

- fixed doc-comments

RB: 24088
RB: 24089
RB: 24090
RB: 24091
RB: 24092
RB: 24093
Change-Id: Idfcec22b4e6235df1eabd6c7713523d7e70d3351