Joshua Eichorn shares some of the updates to the phpDocumentor software in his latest post today:
As PHP keeps added language features one of the things we have to do is figure out how to document them. Lately I've been hearing requests for a way to document virtual properties and methods on classes that are implemented using __call etc.
After talking a bit with Greg, I'm leaning towards adding in some new docblock tags to classes to allow these methods/properties to be documented.
He includes a code example for the documentation method suggested on these new functionality bits. He also asks for comments/ideas on how to hald these sorts of updates in the future.