正确注释 class 方法 return 值

Correct commenting for class method return value

class 方法的正确 PHPDocumentor 注释是什么?returns 如果失败则为布尔值,否则为数组之类的东西。这是我的代码示例:

public function getServers()
{
    $q = $this->db->query('SELECT * FROM servers');

    if($q->execute())
    {
        return $q;
    } else {
        return false;
    }
}

查看 phpDocumentor manual

示例:

/**
 * @return array|bool some result or false if none found.
 */
public function getServers()
{   
[...]