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;