Oracle的 Java 8 的HotSpot实现中引入的一些小但受欢迎的功能之一是在启动器的文档中添加了许多常见的HotSpot Java启动器 （ java ）选项/标志。 过去，即使是对某些相当常见的HotSpot JVM选项也感兴趣的开发人员 ，不得不潜在地寻找多个不同的来源，以在这些标志上找到“官方”文档。 这些资源包括上述的Java启动器文档以及所有其他资源，例如带HotSpot VM的Java SE 6 故障排除指南，HotSpot VM（7）的 故障排除指南和Java 8故障排除指南 。 也有许多“非官方”资源记录了这些选项，例如书籍和Java JVM的-XX选项的最完整列表 。

从不同来源了解HotSpot JVM选项时要意识到的风险之一是，很容易开始阅读某个JVM选项，而没有意识到文档明确针对的是除HotSpot之外的JVM（例如JRockit或IBM的JVM） 。 如果开发人员没有密切注意，则JRockit的文档可能特别容易引起误解，因为该文档具有Oracle URL和Oracle徽标。

JRockit JVM选项文档被混淆为HotSpot JVM选项文档的一个示例是博客文章How to Fix java.lang.OufOfMemoryError：Direct Buffer Memory的反馈评论 ，该作者通过以下方式“更正”了作者关于默认JVM最大直接缓冲区限制的声明：引用JRockit文档 （但JRockit的默认值为0导致行为与HotSpot的默认值为0完全不同）。 在另一个不同但相关的示例中，尽管问题是“ SUN JVM 1.6的XX：MaxDirectMemorySize的默认值是多少？”，但XX：MaxDirectMemorySize的StackOverflow线程“ 默认值”上的张贴者也会犯同样的错误，并且还引用了JRockit文档 。 在Java启动器主要文档中记录了常见的HotSpot选项，应该有助于减少这些引起人们对HotSpot VM选项行为混乱的常见原因。

现在，直接在Java启动器（适用于该选项的可执行java ） 文档中直接记录了两个HotSpot JVM选项示例，分别是-XX：+ HeapDumpOnOutOfMemory和-XX：MaxDirectMemorySize 。 Oracle HotSpot 8 Java启动器的文档描述了以下两个示例选项：

Java启动器文档的先前版本（例如，针对Java 7和Java 6）未描述Java 8之前可用的这些以及其他几个HotSpot JVM选项。 这是一个很小但很受欢迎的添加，只是从较早版本迁移到Java 8的众多原因的一小部分。

翻译自: https://www.javacodegeeks.com/2016/02/improved-documentation-hotspot-options-java-8.html