ZF-8637: Zend_Loader_Autoloader_Interface autoload() - doc missing

Description

phpdoc comment is missing for autoload()-method.

PHPDoc generates "void" returns when @return is missing, but autoload() has to return a boolean.

Here is my recommendation for a phpdoc:


interface Zend_Loader_Autoloader_Interface
{
    /**
     * Autoload a class
     * 
     * @param  string $class 
     * @return mixed true, when $class loaded, ignored to load or other accepted status. false, when class loading failed. Other mixed values, if nescessary.
     */
    public function autoload($class);
}

In most cases autoload() has to return a boolean, but Zend_Loader_Autoloader_Resource implements this interface and returns a mixed value!

Comments

Proposing the attached patch. The updated docblock comments are based on suggestions from the original reporter with some modifications for clarity as well as to fully reflect what is returned upon concrete usage.

[SVN:r22235:wilmoore]

Assigned fix version.