phpDocumentor：带有@var 标签的DocBlock 重复描述

Question

我在 php 摘要中有这个 DocBlock class:

/**
* @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 解析了这个 class；这是 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;