phpDocumentor：仅限文档类

Question

我正在尝试了解phpDocumentor。我通常每个文件都有一个classe。我被迫记录文件和课程吗？我想记录课程（我为什么要记录文件？）但我收到警告......

WARNING in comment.class.php on line 8: DocBlock would be page-level, but precedes class "Comment", use another DocBlock to document the file

我看过http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.quickstart.pkg.html。

谢谢

Answer 1

您不必记录文件，这只是一个警告。如果您没有放置文件级文档，那么就不会有关于phpdoc“文件”列表的信息，即使“类”列表中有一些也是如此。