If I add doc comments to my method like this:

/**
 * @return int
 *  The return value
 */
public function myMethod() { ... }

Then the "hint" that appears when I hold CTRL and hover over a call to that method looks like this:

Returns:
  Type: int The
  Description: return value


But if I put the description on the same line, it works properly:

/**
 * @return int The return value
 */
public function myMethod() { ... }

Returns:
  Type: int
  Description: The return value


Shouldn't NetBeans allow me to format my doc comments either way?