phpDocumentor：仅文档化类

Question

4

我正在学习phpDocumentor。通常我会将每个类放在一个文件中。我是否必须记录文件和类？我只想记录类（为什么要记录文件？），但是我收到了警告...

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

谢谢你

- thomas

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Explosion Pills · Accepted Answer

你不必为文件编写文档，这只是一个警告。如果你没有在文件级别上编写文档，那么在phpdoc的“文件”列表中将没有任何信息，尽管在“类”列表中可能会有一些。