PHPDocumentor可选参数

/**
 * daysBetween
 *
 * Returns the number of whole working days between start_date and end_date. Working
 * days exclude weekends and any dates identified in holidays.
 * Use NETWORKDAYS to calculate employee benefits that accrue based on the number of
 * days worked during a specific term.
 *
 * @param   DateTime    $startDate     Start date
 * @param   DateTime    $endDate       End date
 * @param   DateTime    $holidays,...  Optional series of dates that will be excluded
 * @return  integer    Interval between the dates
 */
public function daysBetween($startDate,$endDate) {
    //  Shift the mandatory start and end date that are referenced 
    //  in the function definition,to get any optional days
    $holidays = func_get_args();
    array_shift($holidays);
    array_shift($holidays);

$startDate和$endDate是必需参数,而$holidays的所有实例都是可选的……可能没有定义,一个或多个$holiday日期.上面的PHPDocumentor定义给了我

Parameter $holidays,… could not be found in daysBetween()

我相信我可以通过修改方法定义来解决这个问题

public function daysBetween($startDate,$endDate,$holidays=NULL) {

但这感觉非常糟糕,我不相信我必须改变我的功能定义才能记录它.有人有任何其他建议吗？

附：我正在使用PHPDocumentor2