Better comments phpdoc on functions

[eluser]Lechuss[/eluser]
Another one questions about comments:

Use Having for example:

Code:

/**
* Sets the HAVING value
*
* Separates multiple calls with AND
*
* @param string
* @param string
* @return object
*/
public function having($key, $value = '', $escape = TRUE)
{
return $this->_having($key, $value, 'AND ', $escape);
}

Shouldnt it be?:

Code:

/**
* Sets the HAVING value
*
* Separates multiple calls with AND
*
* @param string key
* @param string value
* @param string escape=TRUE  <---- third parameter?
* @return object
*/
public function having($key, $value = '', $escape = TRUE)
{
return $this->_having($key, $value, 'AND ', $escape);
}