Как указать что doc-block должен наследоваться от метода родительского класса?

Question

[simpfc]

Не могу разобраться как же указать phpDocumentor-у что нужно наследовать dock-block метода родительского класса.

В исходниках Yii встречается тег @inheritdoc.

/**
     * @inheritdoc
     */
    public static function populateRecord($record, $row)
    {
        // ..code
    }

Пробую его, всё что он делает, это добавляет в документации рядом с методом в деталях - " Tags inheritdoc "


Почитал за этот тег тут в доке - www.phpdoc.org/docs/latest/guides/inheritance.html
Пробую использовать его как инлайновый тег ( {@inheritDoc} и {@inheritdoc} )
Получаю вот что.

Если я правильно понял, вообще док-блоки должны наследоваться автоматически, согласно документации, а тег inheritdoc используется что бы явно указать.
Но воспользоваться наследованием док-блоков у меня так и не получилось для переопределённых методов. И идеи в чём же дело у меня иссякли.

UPD
Иерархия классов


Странно что метод ActiveRecord::transactions() наследует описание, а вот Model::scenarios() уже не наследует, может всё дело в том что он намного выше в иерархии ?

Answer 1

[Антон Шаманов]

Проверь реализовано ли оно вообще - размести оба класса в 1 файле, если сработает, то документатор просто "не видит" родительский класс.