我正在尝试在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。
答案 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/