@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...