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

http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.quickstart.pkg.htmlを読みました。

ありがとうございました

4

1 に答える 1

1

ファイルを文書化する必要はありません。これは単なる警告です。ファイル レベルのドキュメントを配置しない場合、phpdoc の「ファイル」リストには情報がありません (「クラス」リストには情報があります)。

于 2010-10-11T14:04:45.370 に答える