5

module-info除了package-info以前存在的文件之外， Java 9 模块功能还添加了（更高级别的）文件。（源代码）文件是否可以module-info.java包含 JavaDoc 工具将提取并（有用地）作为模块级文档呈现的标记注释？

4

2 回答 2

5

一句话—​​—是的。例如，您可以看到 Java 9 的 Javadoc 如何拥有模块级文档，然后列出其中的包及其文档。反过来，这些包包含类及其文档。

作为一个简单的示例，请查看jdk.shell模块文档。

于 2018-12-28T11:09:14.780 回答
2

是的。模块声明支持的标签有：

模块声明

{@author}, {@deprecated}, {@provides}, {@see}, {@since}, {@serialField}, {@uses}, {@version}
{@code}, {@docRoot}, {@index}, {@link}, {@linkplain}, {@literal}, {@summary}

来源：-标准 doclet 的文档注释规范

其中，您可能会进一步感兴趣的新引入标签是：

  1. @index
  2. @summary

然后module具体

  1. @provides
  2. @uses
于 2018-12-28T13:42:21.123 回答