Javadoc создан для класса, который не существует

Question

Проект состоит из корня pom.xml, который имеет несколько модулей. Корневой пакет com.example не содержит кода вообще (no src). Модули каждый из которых содержит один пакет, с подпакетами, в типичной структуре Maven: com.example.foo, com.example.bar, com.example.bar.baz и т.д.

У меня есть groups configuration в моем корне pom.xml.

Я делаю javadocs командой mvn clean javadoc:aggregate.

В результате Javadocs группа упаковки, как и ожидалось, с одним исключением: я также получаю Javadocs для корневого пакета com.example, в группе Другие пакеты и содержит один класс, App, который имеет замечание Hello world!. Однако этот App не существует, на самом деле grepping через всю кодовую базу для Hello world! приводит к нулю результатов.

Как избежать создания документов для не существующего класса?

Уже пробовал:

• <excludePackageNames>com.example</excludePackageNames> -> это не приводит к Javadoc, вырабатываемой на всех, потому что он также исключает подпакеты.

Answer 1

Отвечая на мой вопрос.

Добавить <subpackages>com.example.foo:com.example.bar:com.example....<subpackages> в конфигурацию и опустить корневой пакет com.example.

Это работает как ожидалось, но недостатком является дублирование конфигурации.

Я по-прежнему приветствую любые ответы, которые объясняют, почему и как это происходит. Из-за интеллектуального любопытства генерируется javadoc.