some jsdoc/minor changes