多个javadoc命令可以输出到同一目录层次结构吗?

时间:2011-08-17 23:44:27

标签: javadoc

我的构建文件中有多个目标,我称之为Foo和Bar。假设首先构建Foo。每个目标都包含运行javac,jar和javadoc的任务。

我希望两个javadoc命令都使用相同的目标目录;但是,Bar的javadoc命令会生成一个包装列表文件,用于覆盖Foo的包列表。另外,我希望Bar的javadoc能够链接到为Foo生成的javadoc,但只有在它可以读取的包列表时才会这样做 - 这将在我想要它写的同一位置。

我没有创建单独的Javadoc目标的原因是我希望能够为Foo构建javadoc,无论Bar是否编译,反之亦然。

(如何)我可以将多个javadoc命令写入同一个基目录?

1 个答案:

答案 0 :(得分:0)

我认为没有一种好方法可以做到这一点 - 不仅有包列表,而且还有一些其他文件将由两个javadoc进程重新生成(不同):

  • 恒定values.html
  • allclasses-frame.html
  • allclasses-noframe.html
  • 弃用-list.html
  • index-all.html(或每个字母的索引文件)
  • 概述-frame.html
  • 概述-summary.html
  • 概述-tree.html
  • 序列-form.html

这些是可能的替代方案:

  • 生成单独的输出,但将它们相互链接(使用-link-linkoffline选项)。

  • 使用已知要编译的其他项目的最新版本生成公共输出。使用您的版本控制系统。

  • 偶尔会产生一个大输出(即来自稳定版本)。

    然后仅重新生成项目的部分(进入新目录),然后在大输出上复制它(没有顶级目录中的文件,即概述和框架集文件)。顶级框架集中的索引,树和类列表不是最新的,但这些更改的频率是多少?

如果您想投入大量时间,可以修改第三个选项,将新的顶级文件合并到现有文件中。祝你好运。