10

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

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

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

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

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

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

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

4

1 回答 1

6

Scala 库位于类路径中,否则 scaladoc 会很快出现错误。您看到的警告意味着 scaladoc 不知道如何链接到 Option。为此,您需要使用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/
于 2012-12-12T03:10:11.410 回答