phpDoc comments

[blueyed]

This is a request for phpDoc comments.

Probably the best phpDoc creator is phpCodumentor. Already in the current state of source code it provides a quite nice documentation, but of course this is no reason to not go with the documentation standard.

This would help contributors a lot.

Please think about it.

phpDocumentor documentation created by phpDocumentor (you can see other default output formats at http://phpdoc.org/docs/