PHPDocumentor, phpdoc - отсутствуют комментарии к файловым и глобальным переменным; alse и rue

Я новичок в phpDocumentor, хотя в прошлом активно использовал JavaDoc.

Для начала я создал следующий тестовый файл a.php :

      <?php
  /**
   * XYZ file-level comment.
   */

  /**
   * XYZ global variable comment.
   *
   * @var int
   */
  $var = 123;

  /**
   * XYZ constant comment.
   *
   * @var boolean
   */
  const DO_IT = false;

?>

А затем я запустил phpDocumentor v3.0.0, используя следующую командную строку :

      php D:\phpDocumentor\phpDocumentor.phar

В итоговой документации есть следующие проблемы - см. Снимок экрана здесь :

  1. В сгенерированном HTML-коде нет ни комментариев на уровне файла, ни глобальной переменной $ var.
  2. Для константы DO_IT первая буква значения по умолчанию отсутствует («alse»).

Есть идеи, что я делаю не так? Спасибо!

0 ответов

Другие вопросы по тегам