I've posted phpdoc output from a full run against the entire Moodle 1.6dev code. Developers, here is an example as to why you should be including good phpdoc comments for every new function, define, class and file and why you should be updating the comments on functions as you use them.
http://moodle.sourceforge.net/dhawes-phpdoc
General developer forum
Comments in PHPdoc style
This discussion has been locked so you can no longer reply to it.