It's been years now since I last looked at how to generate PHP API documentation in HTML directly from the sources. I came to use PHPDoc - which worked after some hacks, but wasn't really nice.

Now the right tool for the job seems to be phpDocumentor - must find some time to check this out...