more jsdoc clarifies