Einzel Dokumentation für gemischtes (Scala / Java) Projekt?

Question

Für ein Projekt mit Modulen in Scala und Java (nebeneinander), wie scaladoc mit javadoc zu kombinieren, für das Projekt eine einheitliche Sicht auf die Dokumentation zur Verfügung zu stellen?

(dies unter Verwendung von Maven sein könnte, oder Ameise oder sbt, mehr eine allgemeine Frage).

Alle Gedanken und Erfahrungen zu schätzen.

Answer 1

Mit Scala 2.8 Der neuen scaladoc, die das mit Scala 2.7 verwendete ersetzen wird, werden die Unterschiede noch deutlicher sein. Allerdings gab es eine Anforderung, dass eine Funktion, die übersetzte scaladoc in javadoc-Format zur Verfügung gestellt werden, für die Verwendung durch IDEs bei der Anzeige von Hilfe.

Wenn diese Funktion verfügbar ist, dann etwas, das javadocs von scaladocs wäre theoretisch möglich erzeugt.

Aber für irgendetwas davon wahr geworden, die Menschen, die Interesse daran haben, so etwas würde in den entsprechenden Gremien sprechen. Und natürlich, wenn sie eine zu kleine Gruppe sind, ist es wahrscheinlich nichts passiert, wenn sie es für sich selbst tun.

Answer 2

Was ist de Vorteil Scaladoc mit <> Javadoc? Es gibt eine große Anzahl von Werkzeugen für Javadoc und fast alles für Scaladoc. Der Mainstream-IDEs (Eclipse, Netbeans, Idea - reale Welt der Entwicklung von Unternehmen - nicht den akademische Forschung) weiß nichts über Scaladoc. Scheint, wie in Sibirien sein. Isoliert

Answer 3

Scaladocs und javadoc sind sehr unterschiedlich, mit unterschiedlichen Formaten. Sie sind nur zwei verschiedene Tiere, und ich glaube nicht, es sinnvoll, sie zu kombinieren macht. Also, AFAIK, Maven bietet keine Unterstützung für das (was nicht verwunderlich ist), erzeugen nur beide getrennt.