Joshua Eichorn has posted about the new release (candidate) of one of the standards when it comes to documentation in PHP - phpDocumentor. They've just posted version 1.3.0RC6.
PHP 5 support and more. The vast majority of the bugs in both the Sourceforge tracker and on in the PEAR bug database have been fixed in this release. We hope to follow it up shortly with a 1.3.0 final.
This release fixes a large number of bugs, and switches to the LGPL license instead of the PHP License.
There's also several new features that have been introducted in this release, including: customizable README/INSTALL/CHANGELOG files, a change to where it looks for .ini files, images can be included with the <graphic> tag, and, of course, full PHP5 support.