Каковы потребности {Legitdoc}?

Question

Я много имею дело с Drupal и классами и иногда читаю что-то вроде:

/**
  * {@inheritdoc}
  */

  // return the form definition
  public function buildForm(array $form, FormStateInterface $form_state) {
    $config = $this->config('hello_world.custom_salutation');

    $form['salutation'] = array(
      '#type' => 'textfield',
      '#title' => $this->t('Salutation'),
      '#description' => $this->t('Si prega di inserire il saluto che si desidera usare'),
      '#default_value' => $config->get('salutation'),
    );

что означает унаследовать?

Answer 1

Это синтаксис docblock , который является частью стандартов документации и комментариев API Drupal :

Вы можете использовать {@inheritdoc} в классе

если вы переопределяете или реализуете метод из базы класс или интерфейс, и документация должна быть точно такой же в качестве базового класса / метода интерфейса

В нем также говорится, что эта должна быть единственной строкой в ​​докоблоке.