phpDocumentorに仮想プロパティ用の新記法？
PHPのマジックメソッド（__get、__set、__callなど）を使って仮想的なプロパティを実装した場合にphpDocumentor用のdocblockをどう書けばよいか、ということで次のような新しい記法の導入が提案されています。
/**
* @property int $blah this is the short desc (no long desc allowed)
* @property-read int $foo read-only variable
* @property-write string $oof write-only variable
* @method int myfunc(int $var, string $param2, Object $param3 = null) description of myfunc
*/
class magicClass {
}
提案の中でも指摘されていますが、プロパティについての説明が長くなるとあまり見栄えが良くないのが難点ですね。