Well, when files that are phpDoc-ed have include() or
include_once() directives in them which do not have
appropriate phpDoc tags to document them, individually,
only the page-level docblock, the error page reports eg.
addcomment.php
Warnings:
Warning on line 47 - Page-level DocBlock precedes
"include_once addcomment.php", use another DocBlock to
document the source element
Whereas line 47 of addcomment.php is actually:
include_once("modules/mainlayout/adminmenu.php");
So the name of the file it says you are including is
actually just the basename of the file it is included from.
This is confusing, but not major I guess. Just thought
I'd report it once I'd confirmed that it wasn't me
hallucinating ;-)
K.