clean up jsdoc

I have fixed some params and errors in the jsdoc comments.