I am having one problem though.
See example

abstract class SimpleObject {
  public function methodOne() {
  }

  public function methodTwo() {
  }
}

class ComplexObject extends SimpleObject {
  public function methodThree() {
  }
}

class Foo {

  /**
   * @var SimpleObject
   */
  private $_object;

  public function __construct(SimpleObject $example) {
    $this->_object = $example;
  }

  /**
   * Example method returns something like SimpleObject
   *
   * @return SimpleObject
   */
  public function getOject() {
    return $this->_object;
  }
}

$foo = new Foo();
$fooObject = $foo->getOject();
/* @var $fooObject ComplexObject */
$fooObject->

Here I would want the vardoc to change what the editor thinks it has in $fooObject. It currently only shows only methods
from the SimpleObject because thats what the getObject method says. But I want the vardoc to override what the method
says it is, because I know what the object type is.

It's also possible that I would want to reuse the varible name.