added missing @type comments
added missing @param comments
added missing return comments
added missing type info on @param comment
* used where unsure of type