java - Doxygen，如何描述一个Java包

Question

我不太确定应该如何使用 Doxygen 记录 Java 包。在 C++ 中，您可以简单地描述声明的 namespace ，但 Java 包从未真正明确声明过。我尝试在包 mypackage.subpackage 之前添加描述；声明，但无济于事。我发现那种工作是如果我要制作一个新文件并简单地做

/**
@namespace mypackage.subpackage
@brief my description
*/

它会出现在 wiki 上，但很奇怪，因为一些包描述正确，其余包重复(未描述要描述的包，而是另一个空包，同名包是创建)

有人知道在 Doxygen 中描述 Java 包的正确方法吗？

Answer 1

来自 stackoverflow.com/questions/7368584/doxygen-and-package-html 的复制粘贴方便引用:

为 Java 包提供文档的新替代方法是使用名为 package-info.java 的文件而不是 package.html。 (故意选择文件名不是有效的类名。)

它有不同的语法:

/**
 * any javadoc comments (including tags)
 */
package name;