update phpdoc with all params and exceptions