How to disambiguate links to methods in scaladoc?

Question

I\'m documenting a Scala class with overloaded methods. How can I distinguish them when referring to them in scaladoc comments? For example, if I have

/**
 * The         


        

Answer 1

What I found very usefull in IntelliJ is right clicking on a method you would like to put in [[ ]] and choosing "Copy reference".

Steps:

1. You find a method you'd like to reference somewhere else.

2. You right click on the method name and choose "Copy reference".

3. You paste it in [[ ]] in your documentation (and write a label of your choice next to it, e.g. "apply(String)").

4. Voilà.