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…