title: How to disambiguate links to methods in scaladoc?
body: <p>I'm documenting a Scala class with <a href="https://en.wikipedia.org/wiki/Function_overloading" rel="noreferrer">overloaded methods</a>. How can I distinguish them when referring to them in scaladoc comments? For example, if I have</p>
  
  <pre><code>/**
   * The most important method is [[Doc.foo]].
   */
  object Doc {
    def foo[A]: A = throw new UnsupportedOperationException;
    def foo[A,B &gt;: A](x: A): B = x;
  }
  </code></pre>
  
  <p>and run <code>sbt doc</code> I get</p>
  
  <blockquote>
    <p>Doc.scala:1: warning: The link target "Doc.foo" is ambiguous. Several (possibly overloaded) members fit the target:</p>
    
    <ul>
    <li>method <code>foo[A,B&gt;:A](x:A):B</code> in object Doc [chosen]</li>
    <li>method <code>foo[A]:Nothing</code> in object Doc</li>
    </ul>
  </blockquote>
  
  <p>Using <code>foo[A,B &gt;: A]</code> etc. to the link doesn't work.</p>