comment formatting

reworked comments to (hopefully) be more compliant with jsdoc convention