Better code markup to facilitate documentation

+ Changed JavaScript files to better conform to jsdoc tool