SBT Scaladoc配置

时间:2012-12-10 19:03:36

标签: scala classpath sbt scaladoc output-directory

我正在尝试在SBT中配置Scaladoc,特别是标题,输出目录和类路径。

我设法通过在build.sbt中添加以下内容来定义标题:

scalacOptions in (Compile, doc) ++= Opts.doc.title("Scala-Tools")

我无法弄清楚如何更改doc输出目录。

我也无法弄清楚如何将jar添加到classpath。我想编辑类路径的原因是因为当我引用它的类时,scaladoc似乎没有得到标准的Scala库,即[[scala.Option]]导致警告“找不到任何链接的成员为“scala.Option”。“

任何帮助,即使以示例SBT配置的形式,也将不胜感激!

我正在使用Scala 2.10-RC3和SBT 0.12.1。

1 个答案:

答案 0 :(得分:6)

Scala库位于类路径中,否则scaladoc会很快就会出错。您看到的警告意味着scaladoc不知道如何链接到Option。为此,您需要使用-external-urls选项或2.10.1中的-doc-external-doc选项。即将到来的2.10.1的scaladoc -help输出显示:

-doc-external-doc:<external-doc>  comma-separated list of classpath_entry_path#doc_URL pairs describing external dependencies.
-external-urls:<externalUrl(s)>   (deprecated) comma-separated list of package_names=doc_URL for external dependencies, where package names are ':'-separated

2.10.1之前的解决方案是使用-external-uris

-external-urls:scala=http://www.scala-lang.org/archives/downloads/distrib/files/nightly/docs/library/
相关问题