For reasons of ease of maintenance AND IDE class auto-completion and member hinting, I\'ve used PHPDoc in my project. Given this example class:
class my_clas
I am not sure about the exact syntax but I am sure that netbeans will adhere to the standard php documentation.
http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.pkg.html http://www.phpdoc.org/