more jsdoc comments from @TomMalbran