variety of minor changes (mostly jsdoc) for pull req