phpDocumentor：帶有@var標記的DocBlock重復描述

Question

我在php抽象類中有這個DocBlock：

/**
* @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之一），並且markdown也未解析。 另一方面， @todo標簽的markdown可以正確解析。

我哪里錯了？ 我錯過了什么？

我在@var標簽中發現了有關markdown的錯誤憑單 ：也許與此問題有關？

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;