COMP: fixed warnings issued by clang's -Wdocumentation

Change-Id: I323fae1a6b9c6221c773c0d7c4813ed7a4e58ea1
Merge topic 'clang-Wdocumentation-fixes' into master

0f9b3d07 COMP: fixed warnings issued by clang's -Wdocumentation