title: A tool to add and complete PHP source code documentation
body: <p>I have several finished, older PHP projects with a lot of includes that I would like to document in javadoc/phpDocumentor style. </p>
  
  <p>While working through each file manually and being forced to do a code review alongside the documenting would be the best thing, I am, simply out of time constraints, interested in tools to help me automate the task as much as possible. </p>
  
  <p>The tool I am thinking about would ideally have the following features:</p>
  
  <ul>
  <li><p>Parse a PHP project tree and tell me where there are undocumented files, classes, and functions/methods (i.e. elements missing the appropriate docblock comment)</p></li>
  <li><p>Provide a method to half-way easily add the missing docblocks by <strong>creating the empty structures</strong> and, ideally, opening the file in an editor (internal or external I don't care) so I can put in the description.</p></li>
  </ul>
  
  <p>Optional:</p>
  
  <ul>
  <li>Automatic recognition of parameter types, return values and such. But that's not really required.</li>
  </ul>
  
  <p>The language in question is PHP, though I could imagine that a C/Java tool might be able to handle PHP files after some tweaking.</p>
  
  <p>Thanks for your great input!</p>