Конфигурация SBT Scaladoc

Question

Я пытаюсь настроить Scaladoc в SBT, в частности, название, выходной каталог и путь к классам.

Мне удалось определить заголовок, добавив в build.sbt следующее:

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

Я не могу понять, как изменить каталог вывода документа.

Я также не могу понять, как добавить банки в classpath. Причина, по которой я хочу отредактировать путь к классам, заключается в том, что, похоже, стандартная библиотека 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/