我是 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')。
知道我做错了什么吗?谢谢!