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

Question

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

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

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

Answer 1

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

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

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

Answer 2

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

Answer 3

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