We will use the documenting commenting system PHPDoc v2.3.5 see detailed description of the syntax there.

Especially the sections Documenting your classes, Method Tags and Field Tags.

Since the above mentioned JavaDoc-Based PHPDoc doesn't work with Java 1.4 anymore, at least not I cannot get it working smothly :-(, we will change to use the PEAR-PHPDoc.