Scaladoc 生成時に、外部のScaladocへリンクをする

scala

数年前からissueはあったようですが、ようやく2.10.0からできるようになりました。

https://github.com/scala/scala/blob/v2.10.0/src/compiler/scala/tools/nsc/doc/Settings.scala#L197-L201

たとえば、Scala本体のScaladocにリンクさせるには、*1 sbtだと以下のように設定

scalacOptions in (Compile, doc) <++= scalaVersion.map{ v =>
  if(v.startsWith("2.10")) Seq("-external-urls:scala=http://www.scala-lang.org/api/" + v + "/index.html")
  else Nil
}


ちなみに、現状Scala2.10.0の時点では、外部のJavadocへはリンクできないようです

だがしかし、一部問題があった(？)のか、masterではこのオプションは既に deprecated になっていて、次期versionでは違うオプションが提供されるようです

https://github.com/scala/scala/blob/22dcec63745c2906c3c0ad636049e4ab0f73233c/src/compiler/scala/tools/nsc/doc/Settings.scala#L202-L206

2.10.0より後のversion (2.10.1もしくは2.11.x)どうなるのかは、現状よくわかりませんが、詳しく知りたい人は、以下のコミットとかissue見てください
https://issues.scala-lang.org/browse/SI-191
https://github.com/scala/scala/pull/1787
https://issues.scala-lang.org/browse/SI-6803
https://github.com/scala/scala/commit/103a478dfc1b3f918e0643333635e3d8d254a9a0
https://github.com/scala/scala/commit/d22b74c22fef4151533bf23efcc6b4f59e60d88f

*1:現状のScala2.10.0の時点では