added missing @return comments
added missing * at start of comment line
fixed mis-named @method comments