Lets say you have a class that acts as a registry and that contains the
magic methods __get($var) and __set($var, $value); Now for most of the
time you cannot be sure what type of variable __get will return but you
do know that __get('foo'); always will return a instance of the Foo
class. According to phpDoc (http://preview.tinyurl.com/2fxl57) you can
add the @property doc tag for the class defining that the property $foo
of the class Registery is a instance of Foo, but PDT does not seem to
take this into account when it comes to auto completing. Is this
something that will be included in a later release?