phpDocumentor: документ только классы - PullRequest
4 голосов
/ 11 октября 2010

Я пытаюсь узнать о 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.

Спасибо

1 Ответ

1 голос
/ 11 октября 2010

Вам не нужно документировать файл, это просто предупреждение.Если вы не поместите документ на уровне файлов, то в списке «файлы» phpdoc не будет никакой информации, даже если она будет в списке «классов».

...