java - 新的 javadoc 注释 @apiNote

Question

我在 LongStream 找到了一个新的未记录的 javadoc 标签类文档。 javadoc 标签@apiNote 似乎用于详细说明某个方法，但没有关于此标签的文档或发行说明。

它的真正目的是什么？它的文档在哪里？

可在 Reduce method documentation 找到使用@apiNote 编译的 javadoc 示例

Answer 1

来自@bargenson引用的邮件列表项目:

These tags are enabled by use of the -tag feature on the javadoc tool command line. They are not proposed as standard javadoc tags and may be implemented differently in future Java releases. Since they are implemented as custom tags just for the JDK API documentation you can't automatically use them in your own code. (You can, of course, add the same command line options to your javadoc invocations if you like these tags).

所以它们根本不是标准的 Javadoc 标签。