Add @return type and @param values in the comment docblocks.

Problem/Motivation

There is no @param and @return documentation for couple functions in the module.

Proposed resolution

Add the @param and @return

Remaining tasks

User interface changes

API changes

Data model changes