java - 混合（Scala/Java）项目的单一文档？

Question

对于具有 Scala 和 Java 模块（并排）的项目，如何将 scaladoc 与 javadoc 结合起来以提供项目文档的单一视图？

（这可能是使用 maven、ant 或 sbt，更一般的问题）。

任何想法和经验表示赞赏。

Answer 1

Scala 2.8 的新 scaladoc 将取代 Scala 2.7 中使用的 scaladoc，差异将更加显着。但是，有人要求提供将 scaladoc 转换为 javadoc 格式的函数，以供 IDE 在显示帮助时使用。

如果这个函数可用，那么从 scaladocs 生成 javadocs 的东西在理论上是可行的。

但要使这一切成为现实，对此类事情感兴趣的人必须在适当的论坛上发言。当然，如果他们的群体太小，除非他们自己动手，否则很可能什么都不会发生。

Answer 2

拥有 Scaladoc <> Javadoc 有什么好处？有大量的 Javadoc 工具和 Scaladoc 的几乎所有工具。主流 IDE（Eclipse、Netbeans、Idea——现实世界的企业开发——不是学术研究）对 Scaladoc 一无所知。仿佛置身于西伯利亚：与世隔绝。

Answer 3

Scaladocs 和 javadoc 非常不同，具有不同的格式。它们只是两种不同的动物，我认为将它们结合起来没有意义。因此，AFAIK，Maven 对此不提供任何支持（这并不奇怪），只需分别生成它们。