SBT Scaladoc配置

Question

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

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

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

我不知道如何更改文档输出目录。

我也不知道如何将jars添加到类路径中。我想要编辑类路径的原因是，当我引用它的类时，scaladoc似乎没有选择标准的Scala库，也就是说，[scala.Option]会导致警告“找不到任何要链接到”scala.Option“的成员”。

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

我使用的是Scala 2.10-RC3和SBT 0.12.1。

Answer 1

Scala库位于类路径中，否则scaladoc很快就会出现错误。您看到的警告意味着scaladoc不知道如何链接到选项。为此，您需要使用2.10.1中提供的-external-urls选项或-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/