Better comments phpdoc on functions

[eluser]Lechuss[/eluser]
Hi,

Would you - Developers - write a better comments on functions? Something like that:

GOOD:

Code:

/*
* Generates a SELECT MAX(field) portion of a query
  *
  * @param string the field
  * @param string an alias
  * @return object
  */
public function select_max($select = '', $alias = '')

BAD (missing description of pamateres):

Code:

/**
* Sets the OR HAVING value
*
* Separates multiple calls with OR
*
* @param string
* @param string
* @return object
*/
public function or_having($key, $value = '', $escape = TRUE)

It helps to work with autocomplete in Netbeans.