title: How do you document your PHP functions and classes inline?
body: <p>I know there are many different standards for PHP code inline documentation. Here's what I mean by inline documentation, and please correct me if there is a better term:</p>
  
  <pre><code>/**
  * This is the description for the class below.
  *
  * @package    my-package
  * @subpackage my-subpackage
  * @author     my-name
  * @version    my-version
  * ...
  */
  class orderActions {
  ...
  </code></pre>
  
  <p>What is the best and most widely-accepted form of inline documentation? In other words, what are those forms of inline documentation that everyone agrees on, and are not significantly based on opinions; the universally accepted forms of PHP in-line documentation that everyone should know about, but as a questioner, I'm not sure of yet, but after this question is answered, I will have a good overview of, not involving any particular opinions.</p>
  
  <p>Are there any tools to auto-generate such documentation, or does it have to be done by hand?</p>
  
  <p>I'm not interested in generating manuals -- I want to know how to generate the type of code commenting above, or "inline documentation."</p>