phpDocumentor: DocBlock с тегами @var дублирует описания
У меня есть этот DocBlock в абстрактном классе PHP:
/**
* @var string $foo a useful foo and <code>some.code()</code> too
* @var string $bar a useless bar
*
* @todo do something with <code>$this->bar</code>
*/
protected $foo, $bar;
Я проанализировал этот класс с phpDocumentor; и вот результат HTML:
Как вы можете видеть оба $foo а также $bar разделяет одно и то же описание ($ foo one) и уценка тоже не анализируется.
С другой стороны уценка @todo тег правильно проанализирован.
Где я не прав?
Я что-то пропустил?
Я нашел ошибку билет о уценке в @var теги:
Может быть, это как-то связано с этой проблемой?
Решение
Я всегда документирую выше самого вар. Может быть, это проблема
/**
* @var string $foo a useful foo and <code>some.code()</code> too
*/
protected $foo;
/*
* @var string $bar a useless bar
*
* @todo do something with <code>$this->bar</code>
*/
protected $bar;
Другие решения
Других решений пока нет …