scaladoc Ant 任务为多个源目录编写？

Question

我希望在一个同时包含 scala 和 java 的项目中编译 scaladoc 和 javadoc 。该项目有多个源目录（每个目录可能有 scala 或 javadoc）。我尝试过：

  <scaladoc destdir="doc">
    <classpath refid="compile.classpath"/>

    <src>
      <fileset dir="src"/>
      <fileset dir="tweetstream4j/src"/>
    </src>

    <include name="src/**/*.scala"/>
  </scaladoc>

及其几种变体。对于上述变体，我得到：

BUILD FAILED
/blah/build.xml:119: /blah/src/com/foo/Blah.java is not a directory.

其中“Blah.java”是我的源代码树中的一个文件。

我查看了 scaladoc ant 任务文档 和 scaladoc 手册页。我正在使用 scala2.7.7final （因为这是 apt-get 在我的 Ubuntu 系统上安装的）。

关于如何从“src”和“tweetstream4j/src”中获取scaladoc和javadoc的建议？

Answer 1

我有同样的问题并遇到了这个。这些 元素似乎没有很好的文档记录，但我能够从网上找到的各种示例中整理出一些有用的东西：

<scaladoc destdir="doc">
    <classpath refid="compile.classpath"/>
    <src path="src"/>
    <src path="tweetstream4j/src"/>
    <include name="**/*.java"/>
    <include name="**/*.scala"/>
</scaladoc>

这将在所有 Java 和 Scala 的源目录中查找编写代码并为其构建一套文档。