cmb wrote:It seems to me that it makes sense to upgrade to phpDocumentor 2 when we drop PHP 4 support and use PHP 5 features, because the documentation would hugely benefit of the improved support for member visibility and the documentation of exceptions (@throws). The missing support for @global is a problem, but maybe somebody will tackle it in the meantime (even a partial implementation might suffice for our purposes), and IMO we should get rid of the many global variables ASAP, anyway.
Time flies (I've posted this 2½ years ago), and I think it's time for a change. phpDocumentor 2 still doesn't support the declaration of global variables and I have lost faith that it ever will. Therefore I propose to switch to Doxygen which is probably the most feature complete general documentation generator, even though PHP isn't 100% supported (for instance, the namespace separator has to be :: instead of PHP's \ in doc block comments for automatic linking). I have opened a "doxygen" branch which is supposed to serve as POC only, and have uploaded the generated documenation.