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
В итоговой документации есть следующие проблемы - см. Снимок экрана здесь :
- В сгенерированном HTML-коде нет ни комментариев на уровне файла, ни глобальной переменной $ var.
- Для константы DO_IT первая буква значения по умолчанию отсутствует («alse»).
Есть идеи, что я делаю не так? Спасибо!