PhpDocumentor: DocBlock с @var тегами дублирует описания

Question

У меня есть этот 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 один) и уценки не разобранные тоже. С другой стороны, уценка тега @todo правильно разобрана.

Где я ошибаюсь? Я что-то пропустил?

Я нашел ошибку ticket about markdown in @var tags: Может, это связано с этой проблемой?

Answer 1

Я всегда документирую над самим 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;