当Javadoc在Java 8中处理包-info.java文件时,输出将Javadoc注释放在生成的类和其他摘要表之后(摘要句除外)。下面是一个Java8示例:https://docs.oracle.com/javase/8/docs/api/java/nio/file/package-summary.html
在Java 8和Java 11之间的某个时候,这种情况发生了变化,Java 11中的Javadoc输出现在将所有Javadoc注释放在生成的类和其他汇总表之前。以下是Java11中的相同示例:https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/nio/file/package-summary.html
我想要但一直找不到的是一种在Java 11中控制这种行为的方法,我更喜欢恢复到Java 8行为(在Java 11中),或者更好的是能够控制这种行为,以便在汇总表之前出现一些包注释,而在汇总表之后出现一些包注释。
有办法控制Java 11中的Javadoc行为吗?目前,我只能使用Java 11,不能使用早期或更高版本的特性。
发布于 2022-01-03 21:31:36
可以使用doclet定制javadoc命令输出的内容和格式。javadoc命令有一个默认的内置doclet,称为Standard,它生成HTML格式的API文档。您可以编写自己的doclet来生成HTML、XML、MIF、RTF或任何您想要的输出格式。
StandardDoclet委托给HtmlDoclet。您可能可以通过子类化和重写generatePackageFiles来避免这种情况。
国际海事组织可能不值得这么做,但是嘿。
https://stackoverflow.com/questions/70571494
复制相似问题