title: functions overloaded with different number of arguments
body: <p>A lot of the Clojure functions accept various number of arguments and I'm often a bit confused by the documentation and how it relates to the way I should be using the function.</p>
  
  <p>For example <code>(doc partial)</code> returns this:</p>
  
  <pre><code>([f arg1] [f arg1 arg2] [f arg1 arg2 arg3] [f arg1 arg2 arg3 &amp; more])
  </code></pre>
  
  <p>My question is not specifically about <em>partial</em> but...</p>
  
  <p>Why up to <em>arg1 arg2 arg3 &amp; more</em> and not <em>arg1 &amp; more</em> or <em>arg1 arg2 &amp; more</em> or <em>arg1 arg2 arg3 arg4 arg5 arg6 arg7 arg8 &amp; more</em> ?</p>
  
  <p>I'm being facetious with the last one but this is a very real question: what determines how many "argX" one needs to put before the <em>&amp; more</em>?</p>