Единая документация для смешанного проекта (Scala/Java)?

Для проекта с модулями в Scala и Java (бок о бок), как объединить scaladoc с javadoc, чтобы обеспечить единый вид документации для проекта?

(это может быть использование maven, или ant, или sbt, более общий вопрос).

Любые мысли и переживания оценены.

Ответ 1

С Scala 2.8 новым скалядоком, который заменит тот, который используется с Scala 2.7, различия будут еще более впечатляющими. Однако был запрос о предоставлении функции, которая переводила scaladoc в формат javadoc, для использования IDE при отображении справки.

Если эта функция становится доступной, то теоретически возможно то, что генерирует javadocs из scaladocs.

Но для того, чтобы это стало истинным, люди, которые заинтересованы в таком, должны были высказаться на соответствующих форумах. И, конечно, если они слишком маленькие, группа, скорее всего, ничего не произойдет, если они не сделают это для себя.

Ответ 2

Какое преимущество имеет Scaladoc < > Javadoc? Существует огромное количество инструментов для Javadoc и почти что-то для Scaladoc. Основные среды IDE (Eclipse, Netbeans, Idea - развитие реального мира - не академические исследования) ничего не знают о Scaladoc. Кажется, что в Сибири: изолированный.

Ответ 3

Scaladocs и javadoc очень разные, с разными форматами. Они всего лишь два разных животных, и я не думаю, что имеет смысл объединить их. Таким образом, AFAIK, Maven не предлагает никакой поддержки для этого (что неудивительно), просто создайте оба из них отдельно.