僅適用於package-info.java的javadoc

Question

我有一種情況，我想在沒有類的項目中執行javadoc。 它只有一個包的package-info.java。 執行javadoc時，會出現以下錯誤：

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

有沒有辦法強迫它只處理package-info.java（除了顯而易見的hacky解決方案：創建一個虛擬類，腳本復制package.html等）？

我正在執行javadoc作為maven構建的一部分，所以maven-javadoc-plugin正在執行實際的javadoc命令。

Answer 1

沒有辦法讓JavaDoc在空包上運行。 發布了一個非常老的錯誤標記為“已關閉，無法修復”。

在那個bug中，解決方法幾乎是你提到的顯而易見的hacky，創建一個默認范圍的空類。 除非你強制它與-package或-private一起使用，否則該類不會包含在javadoc中。

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