documentación única para el proyecto mixto (Scala / Java)?

Question

Para un proyecto con módulos en Scala y Java (lado a lado), la forma de combinar scaladoc con javadoc para proporcionar un único punto de vista de la documentación para el proyecto?

(esto podría ser el uso de Maven, o una hormiga, o SBT, más una cuestión general).

Cualquier pensamientos y experiencias apreciados.

Answer 1

Con la nueva scaladoc de Scala 2.8 que sustituirá a la utilizada con Scala 2.7, las diferencias serán aún más sorprendente. Sin embargo, hubo una solicitud de que se proporcione una función que traduce scaladoc en formato Javadoc, para uso de los entornos de desarrollo cuando la ayuda se presentan.

Si esta función esté disponible, a continuación, algo que genera javadocs de scaladocs sería teóricamente posible.

Sin embargo, para cualquiera de que para ser cierto, las personas que tienen interés en una cosa así tendrían que hablar en los foros adecuados. Y, por supuesto, si son un grupo muy pequeño, es probable que no pasa nada a menos que lo hagan por sí mismos.

Answer 2

¿Qué hay de las ventajas de tener Scaladoc <> Javadoc? Hay un gran número de herramientas para Javadoc y casi cualquier cosa por Scaladoc. Los entornos de desarrollo de corriente (Eclipse, Netbeans, la idea - el desarrollo de empresas en el mundo real - no investigación académica) nada sobre Scaladoc sabe. Parece como estar en Siberia:. Aislado

Answer 3

Scaladocs y javadoc son muy diferentes, con diferentes formatos. Son sólo dos animales diferentes y no creo que tiene sentido para combinarlos. Así que, que yo sepa, Maven no ofrece ningún apoyo para eso (que no es de extrañar), acaba de generar tanto de ellos por separado.