title: How to document a argument list with a variable length with known parameter types?
body: <p>Related: <a href="https://stackoverflow.com/q/4729516/427545">Correct way to document open-ended argument functions in JSDoc</a></p>
  
  <p>I've a function that accepts multiple arrays by accessing the <code>arguments</code> variable:</p>
  
  <pre><code>/**
   * @param options An object containing options
   * @param [options.bind] blablabla (optional)
   */
  function modify_function (options) {
      for (var i=1; i&lt;arguments.length; i++) {
          // ...
      }
  }
  </code></pre>
  
  <p>Now, I know that each argument besides <code>options</code> is an array containing values that are worth documenting:</p>
  
  <pre><code>[search_term, replacement, options]
  </code></pre>
  
  <p>I'm not considering putting the (lengthy) description in the variable parameter line.</p>
  
  <blockquote>
    <p>@param {...} An array with search terms, replacements and its options; index 0: the search term within the function; 1: the replacement text; 2: optional options (catch_errors: catches errors and log it, escape: escape dollars in the replacement text, pos: "L" for placing the replacement before the search term, "R" for placing it after)
    Not a readable solution and the type is not visible.</p>
  </blockquote>
  
  <p>Is there a way to document the types and values of a variable parameter?</p>
  
  <pre><code>@param {...[]} An array with search terms, replacements and its options
  @param {...[0]} The search term within the function
  @param {...[1]} The replacement text 
  @param {...[2]} An optional object with obtions for the replacement
  @param {...[2].catch_errors} catches errors and log it
  @param {...[2].escape} etc...
  </code></pre>
  
  <p>The above looks ugly, but it should give you an idea of what I'm trying to achieve:</p>
  
  <ul>
  <li>document the type of a variable parameter (in this case an Array)</li>
  <li>document the values of this array</li>
  <li>document the properties of an object inside this array</li>
  </ul>
  
  <p>For laziness, I've used an array instead of a object. Other suggestions are always welcome.</p>