scala - SBT Scaladoc 配置

Question

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

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

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

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

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

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

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

Answer 1

Scala 库在类路径上，否则 Scaladoc 会很快出现错误。您看到的警告意味着 scaladoc 不知道如何链接到 Option。为此，您需要使用 -external-urls选项或 -doc-external-doc 2.10.1 中的选项。 scaladoc -help的输出对于即将到来的 2.10.1 节目:

-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/