move to jsdoc
fix jshint errors introduced by 382adefbf810d33cf8da8fc5d15c0baee3b123bb
small fixes to jsdoc