Если по человечески указать то все работает
@return self

_____________
Mysql, Postgresql, Redis, Memcached, Unit Testing, CI, Kohana, Yii, Phalcon, Zend Framework, Joomla, Open Cart, Ymaps, VK Api

проблема с кодировкой возникает, когда открываешь файл вне проекта. Все 6-ые версии и начало 7-ых игнорировали общую установку использовать utf-8 и открывали файлы в хрен знает какой кодировке. Это же касалось и файлов, которые подключались как внешние библиотеки. В обшем фигня полная и не удобная. Но этом моё личное мнение.

_____________
Gear Framework
Gear Framework на Github

self и static это разные вещи вообще-то. вот человеческий пример который человечески работает в NetBeans.

namespace test;

class A
{
    /**
     * @return \static
     */
    function foo() {}
}

class B extends A
{
    /**
     * @return \static
     */
    function boo() {}
}


$b = new B();
$b->boo()->foo()->boo()->foo()-> # ctrl+space должны выпасть оба метода foo и boo

Они замудрили конечно со слэшом в начале, может сделают в след. версиях без слэша. А в PHPStorm такое не работает ни в каких вариантах ни с слэшом ни без слэша ни static ни this ни $this, вобщем никак.

про сторонние файлы не спорю. бинс предназначен только для работы с проектами, а не как редактор файлов. в этом может быть и минус. У меня линукс и тут по умолчанию все открывается в утф включая не проектные файлы, в винде может по-другому.

/**
 * @return \static
 */

Каким местом это выглядит ерундой? Это называется Method chaining, используется повсеместно.

@return $this
@return this
@return static
это все синонимы. необходимы когда у вас в коде return $this или return new static().
Если у вас только один класс без наследований, то шторм справляется нормально, а когда класс наследуется от другого, то шторм не отслеживает цепочку вызовов.

Я о $this писал. Которого я в PhpDoc не наблюдаю, по сути просто имя переменной, это приблуда самого NetBeans.

_____________
Mysql, Postgresql, Redis, Memcached, Unit Testing, CI, Kohana, Yii, Phalcon, Zend Framework, Joomla, Open Cart, Ymaps, VK Api

Ну так не работает @return $this в шторме: замените \static на $this в моем примере выше и шторм в выпадающем списке покажет только один метод foo. Т.е. @return $this обрабатывается фактически как @return self, но это не корректно для наследуемого класса. В стандартном пхпдоке этого нет, но там и @var например нет, для обычных переменных а не для свойств класса, тем не менее этим пользуются потому что это удобно. и цепочки вызовов это удобно и многие этим пользуются.

Попробую как на работу выйду. Вообще вроде обновляюсь регулярно. Поновей это всмысле EAP или стабильную?

для одного класса всегда работало, можно даже пхпдок не писать если в коде return $this, фигня начинается если из класса наследника вызвать метод родительского класса который возвращает $this, потом если нарисовать стрелочку -> то в автокомплите выпадет список только родительских методов