[Twig] Add description to PhpTyes @var syntax

[mekras]

There is a great feature but it can be more useful with ability to describe variable like this:

{# @var foo \Foo\Bar description of this variable #}

Currently this is not supported. Without description:

With description:

And will be very nice if the developer can write for template designer something like this:

{##
 # Some description of template, where and when it used
 #
 # @var foo \Some\Foo\Class description of variable "foo"
 # @var var \Some\Bar\Class description of variable "bar"
 #}

[Haehnchen]

thx, really good ideas.
whats about supporting some more doc tags which provides navigation like @see, @link?

[mekras]

whats about supporting some more doc tags which provides navigation like @see, @link?

It will be useful, I think. But no nessesery for me :-)

[King2500]

TwigDoc is born :)

[gharlan]

Imo the variable name and type should be swapped:

{# @var \Foo\Bar foo description of this variable #}

[Haehnchen]

done

[mekras]

Cool!