Tài liệu đơn lẻ cho dự án hỗn hợp (Scala/Java)?

Question

Đối với một dự án với các mô-đun trong Scala và Java (cạnh nhau), làm thế nào để kết hợp scaladoc với javadoc để cung cấp một cái nhìn duy nhất của tài liệu cho dự án?

(điều này có thể sử dụng maven, kiến ​​hoặc sbt, một câu hỏi chung).

Bất kỳ suy nghĩ và trải nghiệm nào được đánh giá cao.

Answer 1

Với scaladoc mới của Scala 2.8 sẽ thay thế mô hình được sử dụng với Scala 2.7, sự khác biệt sẽ còn nổi bật hơn nữa. Tuy nhiên, đã có một yêu cầu rằng một hàm được cung cấp mà dịch biến đổi thành định dạng javadoc, để sử dụng bởi các IDE khi hiển thị trợ giúp.

Nếu chức năng này khả dụng, khi đó một cái gì đó tạo ra javadocs từ scaladocs sẽ về mặt lý thuyết khả thi.

Nhưng đối với bất kỳ điều nào trong số đó trở thành sự thật, những người quan tâm đến điều như vậy sẽ phải lên tiếng tại địa điểm thích hợp. Và, tất nhiên, nếu họ là một nhóm quá nhỏ, nó có khả năng không có gì xảy ra trừ khi họ làm điều đó cho chính họ.

Answer 2

Scaladocs và javadoc rất khác nhau, với các định dạng khác nhau. Họ chỉ là hai loài động vật khác nhau và tôi không nghĩ rằng nó có ý nghĩa để kết hợp chúng. Vì vậy, AFAIK, Maven không cung cấp bất kỳ sự hỗ trợ nào cho điều đó (điều này không đáng ngạc nhiên), chỉ tạo ra cả hai cách riêng biệt.

Answer 3

Ưu điểm của việc có Scaladoc <> Javadoc là gì? Có một số lượng lớn các công cụ cho Javadoc và hầu hết mọi thứ cho Scaladoc. Các IDE chính thống (Eclipse, Netbeans, Idea - phát triển doanh nghiệp thế giới thực - không phải nghiên cứu khoa học) không biết gì về Scaladoc. Có vẻ như đang ở Siberia: cô lập.