phpDocumentor/fig-standards — pull request #55 by mvriel (2014-08-08 11:44:20+00:00)
Title: Reverted @type to @var and changed compound @var notation to match PHPs

> The typedef PR should be merged first, as such for the review of this item https://github.com/phpDocumentor/fig-standards/commit/1d07566e2727c0fffc9256e855977b875ace1b72 can be ignored because it is part of another PR

During discussions is became obvious to me that the proposed rename of
@var to @type encountered quite a bit of resistance and posed difficulties
with existing annotation consumers, such as Doctrine, because they are
using that namepart in their annotation names.

In addition, due to a discussion at http://youtrack.jetbrains.com/issue/WI-7659,
it become obvious that the notation where a DocBlock preceeds an individual
property in a compound statement that it is picked up by PHP's Reflection
library. As such I adapted the spec to match PHP's behaviour.

You can reproduce this using the following script:

getDocComment());
$reflectionProperty = new ReflectionProperty('A', 'c');
var_dump($reflectionProperty->getDocComment());

When you execute this you get the following output:

string(25) "/** This is a DocBlock */"
string(32) "/** This is a second DocBlock */"