Eclipse(PDO)でコード補完させるためのコメントの書き方 ref: http://qiita.com/tadasuke/items/da5551db88594d5e4284

file0.php

class Hoge {
    // 何かしらの処理
}

file1.php

class Factory {
    public static function getHogeInstance() {
        return new Hoge();
    }
}

file2.txt

$hoge = Factory::getHogeInstance();

file3.php

class Factory {

    /**
     * Hogeオブジェクト取得
     * @return Hoge
     */
    public static function getHogeInstance() {
        return new Hoge();
    }
}

file4.php

new $class()

file5.php

class Factory {

    /**
     * Hogeオブジェクト取得
     * @param string $class
     * @return Ambigous
     */
    public static function getInstance( $class ) {
        return new $class();
    }
}

file6.php

/* @var $hoge Hoge */
$hoge = Factory::getInstance( Hoge::class );

file7.php

/* @var $hoge Hoge */