Javadoc для пакета info.java

Question

У меня есть ситуация, когда я хотел бы выполнить Javadoc в проекте, в котором нет занятий. У него есть только пакет info.java для одного пакета. При выполнении Javadoc приведена следующая ошибка:

An error has occurred in JavaDocs report generation:Exit code: 1 - javadoc: error - No public or protected classes found to document.

Есть ли способ заставить его обрабатывать только пакет-info.java (кроме очевидных хакерских решений: создание фиктивного класса, сценария копирования пакета .html и т. Д.)?

Я выполняю Javadoc как часть сборки Maven, поэтому Maven-Javadoc-Plugin выполняет фактическую команду Javadoc.

Answer 1

Там нет способа заставить Javadoc работать на пустой упаковке. Есть действительно старый ошибка Опубликовано для этого как «закрытый, не исправит».

В этой ошибке обходной путь в значительной степени является очевидным хакерским, который вы упоминаете, создайте пустой класс по умолчанию. Класс не будет включен в Javadoc, если вы не заставите его быть с -Пакером или -Про.

/** hack to generate package javadoc */
class PlaceHolder {}