module: Fix Doxygen comment style for consistency

Aligned doxygen tags used in new modules
with existing codebase conventions.

It also fixes comments that mentions wrong
return values

Signed-off-by: Girish Pathak <girish.pathak@arm.com>