> I would suggest to link to it as "relative/path/to/file in the Scala source distribution"

Wouldn't this mean that the link would not work if the Scaladoc is published anywhere? Specifically, it would not even work here:

http://www.scala-lang.org/api/current/index.html#scala.Int$

The `Int.scala` source link in that page points [back to GitHub](https://github.com/scala/scala/blob/v2.10.1/src/library/scala/Int.scala#L1), which is not a relative file path wrt. scala-lang.org (at least, not without a whole bunch of magic, I would guess) :-(

> so as not to hard code a particular branch

Definitely was not happy with that either, but it seems the build version that we would probably want to use here is passed as an arg [when the scaladoc task is invoked](https://github.com/scala/scala/blob/master/build.xml#L901), and I wasn't able to figure out a way of otherwise getting hold of that in the build without major upheaval.

Tips on how that might be done very welcome!