title: PHPDoc: Documenting a function with a variable number of arguments
body: <p>What is the recommended method for documenting a class method that accepts a variable number of arguments?</p>
  
  <p>Maybe something like this?</p>
  
  <pre><code>&lt;?php
  
  class Foo {
      /**
       * Calculates the sum of all the arguments.
       *
       * @param mixed [$arg1, $arg2, ...]
       *
       * @return float the calculated sum
       */
      public static function sum() {
          return array_sum(func_get_args());
      }
  }
  </code></pre>
  
  <p>Note: As a general rule, I imagine this type of thing should be avoided where possible. That being said, it would be nice to still document the remaining few cases where it cannot be avoided.</p>