将多个源语言文档合并到一个 Javadoc JAR

Question

如果我有一个项目应用了 java、groovy 和 kotlin 插件，并且每个插件都编写了代码，我该如何创建（并且应该）创建一个包含所有代码文档？

java 插件给了我javadoc 类，groovy 插件给了我groovydoc 任务，但这些似乎不配合。

我如何将这个文档“合并”成一个单一的有凝聚力的工件？

Answer 1

在java+groovy方面你可以做

groovydoc.source 'src/main/java'

并且只运行groovydoc 任务。唯一的缺点是您将获得所有类的 groovydoc 格式。

然后创建 javadoc JAR 就变成了

task javadocJar(type: Jar) {
    description "An archive of the JavaDocs for Maven Central"
    classifier "javadoc"
    from groovydoc
}