Làm cách nào để loại trừ tệp nguồn java trong tác vụ doc?

Question

Tôi đang sử dụng sbt 0.11.2 cho dự án Java/Scala hỗn hợp. Tôi đã nhận ra rằng khi tôi chạy lệnh doc từ bên trong sbt, nó không chỉ tạo các scaladocs cho các tệp nguồn Scala trong src/main/scala, mà còn cho các tệp nguồn Java trong src/main/java (wiki sbt xác nhận để tạo chúng cho src/main/scala chỉ điều đó có vẻ không đúng).

Tuy nhiên, điều này không có vẻ rất tốt. Ví dụ, đối với một lớp Java có tên là Foo với các phương thức tĩnh có hai mục trong scaladoc được tạo ra: một lớp Foo và một đối tượng Foo. Lớp chỉ liệt kê hàm tạo và đối tượng liệt kê các phương thức tĩnh.

Có cách nào tôi có thể yêu cầu sbt loại trừ thư mục src/main/java khỏi thế hệ scaladoc không? Tôi muốn tạo javadocs cho những người thay thế.

Answer 1

Cách thông thường để xử lý đó là sử dụng inspect để xem thông tin đến từ đâu và sau đó thay đổi. Kiểm tra tại doc lãm compile:sources(for doc), mà là một Seq[java.io.File], và có thể được thay đổi như thế này:

sources in (Compile, doc) ~= (_ filter (_.getName endsWith ".scala")) 

Bạn có thể sử dụng show compile:sources(for doc) để xem những gì nó chứa, và sau đó set để thay đổi nó và kiểm tra lại giá trị của nó.