I prefer to use phpDocumentory to manage the codes comments more efficient and manageable. like this:

phpdoc -f file1,file2 -o docs
phpdoc.bat -d dir1,dir2 -o docs
  

Finally I found it is not easy to use, due to time reason, gave it up. However, got some knowledge of its implements and thoughts.