@all
* Wouldn't it be nice to have a Zenphoto API Documentation in HTML?

PHPDoc
* There is a tool like the famous Javadoc at www.phpdoc.org.
* It creates HTML from your PHP code with the help of special tags like @param, @return
...

ToDo:
* Adapt the existent PHP Comment to be PHPDoc conform.

:-) Way ahead of you. I've been gradually adapting the comments in the code to be PHPDoc friendly, but it'll be a while yet before it's useful.

Great idea though, and it's perfect for theme developers. All the theme functions should be commented first...