phpDocumentor：僅文檔類

Question

我想了解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 

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

謝謝

Answer 1

您不必記錄文件，它只是一個警告。如果您沒有放置文件級文檔，那麼即使「class」列表中有一些文件，也沒有關於phpdoc「files」列表的信息。