javadoc - 为不存在的类生成的 Javadoc

Question

该项目由pom.xml具有多个模块的根组成。根包com.example根本不包含任何代码（没有src目录）。每个模块都包含一个包，带有子包，采用典型的 Maven 结构：com.example.foo、com.example.bar、com.example.bar.baz等。

我的root 中有一个组配置pom.xml。

我正在使用命令制作 javadocs mvn clean javadoc:aggregate。

生成的 javadocs 按预期对包进行分组，但有一个例外：我还获得了 root package 的 javadocs com.example，位于组Other Packages中，它包含一个类 ，App它的注释为Hello world!。然而，这App并不存在，事实上，在整个代码库中寻找Hello world!零结果。

如何避免生成不存在的类的文档？

已经尝试过：

• <excludePackageNames>com.example</excludePackageNames>--> 这导致根本没有生成 javadoc，因为它也排除了子包。

Answer 1

回答我自己的问题。

添加<subpackages>com.example.foo:com.example.bar:com.example....<subpackages>到配置中，并省略根包com.example。

这可以按预期工作，但缺点是配置重复。

App出于求知欲，我仍然欢迎任何解释为什么以及如何生成 javadoc 的答案。