Cómo excluir archivos fuente java en la tarea doc?

Question

Estoy usando sbt 0.11.2 para un proyecto Java/Scala mixto. Me di cuenta de que cuando ejecuto el comando doc desde sbt, no solo crea los scaladocs para los archivos fuente de Scala en src/main/scala, sino también para los archivos fuente de Java en src/main/java (el sbt wiki afirma crearlos solo para src/main/scala eso no parece verdad).

Sin embargo, esto no se ve muy bien. Por ejemplo, para una clase Java llamada Foo con métodos estáticos, hay dos entradas en el scaladoc generado: una clase Foo y un objeto Foo. La clase solo muestra el constructor y el objeto enumera los métodos estáticos.

¿Hay alguna manera en que pueda decirle a sbt que excluya la carpeta src/main/java de la generación scaladoc? Quiero crear javadocs para aquellos en su lugar.

Answer 1

La forma habitual de manejar eso es usar inspect para ver de dónde viene la información, y luego cámbiela. Inspeccionar en doc muestra compile:sources(for doc), que es un Seq[java.io.File], y se puede cambiar así:

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

Puede utilizar show compile:sources(for doc) para ver lo que contiene, y luego set para cambiarlo y comprobar de nuevo su valor.