Allow docblock comments for required files to generate something like this:

/**
 * @see Zend_CodeGenerator_Abstract
 */
require_once 'Zend/CodeGenerator/Php/Abstract.php';

Possible patch to generate docblock comments for required files:

Index: library/Zend/CodeGenerator/Php/File.php
===================================================================
--- library/Zend/CodeGenerator/Php/File.php (revision 21316)
+++ library/Zend/CodeGenerator/Php/File.php (working copy)
@@ -418,7 +418,16 @@
         $requiredFiles = $this->getRequiredFiles();
         if (!empty($requiredFiles)) {
             foreach ($requiredFiles as $requiredFile) {
-                $output .= 'require_once \'' . $requiredFile . '\';' . self::LINE_FEED;
+                if (is_array($requiredFile)) {
+                    if (!empty($requiredFile['docblock'])) {
+                        $output .= $requiredFile['docblock']->generate() . self::LINE_FEED;
+                    }
+                    if (!empty($requiredFile['file'])) {
+                        $output .= 'require_once \'' . $requiredFile['file'] . '\';' . self::LINE_FEED;
+                    }
+                } else {
+                    $output .= 'require_once \'' . $requiredFile . '\';' . self::LINE_FEED;
+                }
             }
 
             $output .= self::LINE_FEED;