If I start a class file with

<?php
/**
* short line
*
* long descr
*
* @author ...
*/
class MyClass
{

...

}
?>

PHPDoc does not recognize the file as class file and reports 2 warnings:

[module] <filename> collision 
PHPDoc is confused: module files must not contain classes. Doc will probably be broken, module gets ignored. 
  
[class]  collision 
Warning: found a module comment in a class file. Module comment gets ignored, doc might be broken. 


If I insert an
require_once ...;
line between
<?php
and the doc comment, everything's fine.