Fix the comments -- mostly the improper and/or missing descriptions
of function parameters.
Signed-off-by: NAbhishek Kulkarni <adkulkar@umail.iu.edu>
Signed-off-by: NEric Van Hensbergen <ericvh@gmail.com>