added proper JSDOC - fix #29