php - 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 のもの) を共有しており、マークダウンも解析されていません。一方、@todoタグのマークダウンは適切に解析されます。

どこが間違っていますか？私は何か見落としてますか？

タグのマークダウンに関するバグチケット@varを見つけました: この問題と何か関係があるのでしょうか?

Answer 1

私は常に変数自体の上に文書化します。多分それが問題です

/**
* @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;