【发布时间】：2014-09-13 17:07:00
【问题描述】：
是否有将新功能引入 Javadoc 规范的版本控制流程？我的问题受到 Java 8 源文档中看似新的标签的启发：@apiNote、@implSpec 和 @implNote。 I'm aware that these tags are not standard and subject to change--如果Java之神决定这些标签在新版本的Javadoc中是标准的，开发者在哪里可以找到这些信息？
我阅读了 Oracle 文档，这些文档引用了从 1.1 到 1.4 的 Javadoc 版本，这可能使人们相信每个 Java 版本都有一个新的 Javadoc 版本，但我不能找到任何证据来支持这个假设。
我发现的与 Javadoc 规范/最佳实践/接受的标签相关的唯一合法参考是：How to Write Doc Comments for the Javadoc Tool。
【问题讨论】：
-
不确定为什么电子邮件线程不是可靠的信息来源；其中提到这些标签不是标准的，它们可能会发生变化。
-
@Makoto 这个问题的重点不在于这些标签，我试图了解 Javadoc 版本控制的工作原理，以及有关新功能的信息的位置。我更新了问题，希望能解决您遇到的困惑。