title: Parsing Javascript files with phpDocumentor
body: <p>I've been playing with phpDocumentor recently and found it quite suitable for my needs. I'm largely working with PHP/HTML/JS/CSS codebases and would like phpDocumentor to parse my Javascript (and perhaps CSS) in order to keep it all together.</p>
  
  <p>I've managed to get phpdoc to parse javascript files contained throughout the codebase - however it rejects the page-level docblock - which results in it rejecting the various tags (see below). I've found that by adding in a PHP open tag (with a JavaScript comment before it) to the top of the JavaScript file, I can get it to parse it just like a PHP file.</p>
  
  <pre><code>// &lt;?php
  /**
   * phpdoc goes here
   * @package
   * @todo
   *   - Todo 1
   *   - Todo 2
   */
  function javascript(goes, here) {
  }
  </code></pre>
  
  <p>I can think of a problem occurring should the webserver be setup to server .js files through PHP. Are there any other problems anyone can think of? Is there a better way to accomplish this? </p>
  
  <p>Thanks</p>