如何在doc任务中排除java源文件？

Question

我正在使用sbt 0.11.2进行混合Java/Scala项目.我已经意识到,当我doc从sbt中运行命令时,它不仅会为Scala源文件创建scaladocs src/main/scala,而且还会为Java源文件src/main/java创建scaladocs(sbt wiki声称src/main/scala仅为此创建它们似乎不是真的).

但是,这看起来不太好.例如,对于Foo使用静态方法命名的Java类,生成的scaladoc中有两个条目:Foo类和Foo对象.该类仅列出构造函数,对象列出静态方法.

有什么方法可以告诉sbt src/main/java从scaladoc生成中排除文件夹吗？我想为那些人创建javadoc.

Answer 1

处理这种情况的常用方法是使用inspect查看信息的来源,然后进行更改.在doc节目中进行检查compile:sources(for doc),这是一个Seq[java.io.File],并且可以像这样改变:

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

您可以使用show compile:sources(for doc)它来查看它包含的内容,然后set更改它并再次检查其值.