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

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

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

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

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

Я также не могу понять, как добавить банки в classpath. Причина, по которой я хочу изменить путь к классам, состоит в том, что, по-видимому, стандартная библиотека Scala не воспринимается scaladoc, когда я обращаюсь к ее классам, то есть [[scala.Option]] приводит к предупреждению "Не удалось найти любой член для ссылки на" scala.Option".

Любая помощь, даже в форме примерной конфигурации SBT, будет оценена!

Я использую Scala 2.10-RC3 и SBT 0.12.1.

Ответы

Ответ 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/