Come escludere i file di origine Java nell'attività doc?

Question

Sto usando sbt 0.11.2 per un progetto Java/Scala misto. Mi sono reso conto che quando eseguo il comando doc da dentro sbt, non crea solo gli scaladoc per i file sorgente Scala in src/main/scala, ma anche per i file di origine Java in src/main/java (il wiki sbt afferma di crearli solo per src/main/scala quello non sembra vero).

Tuttavia, questo non sembra molto bene. Ad esempio, per una classe Java denominata Foo con metodi statici ci sono due voci nello scaladoc generato: una classe Foo e un oggetto . La classe elenca solo il costruttore e l'oggetto elenca i metodi statici.

C'è un modo in cui posso dire a sbt di escludere la cartella src/main/java dalla generazione di scaladoc? Voglio invece creare javadoc per quelli.

Answer 1

Il modo usuale per gestire quello è utilizzare inspect per vedere da dove provengono le informazioni e quindi modificarlo. Ispezione a doc mostra compile:sources(for doc), che è un Seq[java.io.File], e può essere modificato in questo modo:

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

È possibile utilizzare show compile:sources(for doc) per vedere cosa contiene, e quindi set di cambiarla e controllare di nuovo il suo valore.