代码之家  ›  专栏  ›  技术社区  ›  Michael Neale

混合文档(Scala/Java)项目的单一文档?

  •  11
  • Michael Neale  · 技术社区  · 16 年前

    对于具有Scala和Java(并排)中的模块的项目,如何将ScalADoc与JavaDoc相结合,为项目提供文档的单一视图?

    (这可能是使用maven,或ant,或sbt,更一般的问题)。

    任何想法和经历都值得赞赏。

    3 回复  |  直到 12 年前
        1
  •  5
  •   Daniel C. Sobral    16 年前

    随着scala 2.8的新scaladoc将取代scala 2.7所使用的scaladoc,两者之间的差异将更加显著。但是,有一个请求,要求提供一个将scaladoc转换成javadoc格式的函数,供IDE在显示帮助时使用。

    如果这个函数可用,那么从scaladocs生成javadocs的方法在理论上是可行的。

    但要想让这一切成为现实,对这件事感兴趣的人必须在适当的场合发言。当然,如果他们太小,很可能什么也不会发生,除非他们自己去做。

        2
  •  2
  •   Marcos    15 年前

    拥有scaladoc<>javadoc有什么好处?有大量用于javadoc的工具,几乎所有用于scaladoc的工具。主流的IDES(Eclipse、NetBeans、IDEA——真实的企业开发——而不是学术研究)对scaladoc一无所知。好像在西伯利亚:与世隔绝。

        3
  •  1
  •   Pascal Thivent    16 年前

    scaladocs和javadoc是非常不同的,具有不同的格式。它们只是两种不同的动物,我认为把它们结合起来是没有意义的。所以,阿法克,马文没有提供任何支持(这并不奇怪),只是单独生成两个。