PhpDocumentor

When an include/require line is not provided its own
docblock, an error shows up in errors.html like this:

"Page-level DocBlock precedes "include "main.php"", use
another DocBlock to document the source element"

The problem is that the include file shown is not the
value of the include statement... it is actually
showing the name of the file that the include statement
is in. It should instead be showing what the file
value of the include statement is.

You can duplicate this using these two test files:

main.php
<?php
/**
* Page Directive for main.php
*
* @package Main
*/

include ("helper1.php");
?>

helper1.php
<?php
/**
* Page Directive for helper1.php
*
* @package Main
*/

/**
* source files used as imports
*/
include ("helper2.php");
?>

Because the page-level docblock is the only docblock
preceding the "include helper1.php" statement inside
main.php, it results in the errors.html file showing
this error for main.php:

main.php
Warnings:
Warning on line 7 - Page-level DocBlock precedes
"include "main.php"", use another DocBlock to document
the source element


The error text should instead say:
Warning on line 7 - Page-level DocBlock precedes
"include "helper1.php"", use another DocBlock to
document the source element

I will separately submit a patch that addresses this bug.