src/jdk.management/share/classes/com/sun/management/HotSpotDiagnosticMXBean.java

*** 1,7 ***
  /*
!  * Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ---
  /*
!  * Copyright (c) 2005, 2025, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this

*** 114,10 ***
--- 114,17 ---
      /**
       * Generate a thread dump to the given file in the given format. The
       * {@code outputFile} parameter must be an absolute path to a file that
       * does not exist.
       *
+      * <p> When the format is specified as {@link ThreadDumpFormat#JSON JSON}, the
+      * thread dump is generated in JavaScript Object Notation.
+      * <a href="doc-files/threadDump.schema.json">threadDump.schema.json</a>
+      * describes the thread dump format in draft
+      * <a href="https://tools.ietf.org/html/draft-json-schema-language-02">
+      * JSON Schema Language version 2</a>.
+      *
       * <p> The thread dump will include output for all platform threads. It may
       * include output for some or all virtual threads.
       *
       * @implSpec
       * The default implementation throws {@code UnsupportedOperationException}.

*** 149,9 ***
--- 156,10 ---
           * Plain text format.
           */
          TEXT_PLAIN,
          /**
           * JSON (JavaScript Object Notation) format.
+          * @spec https://datatracker.ietf.org/doc/html/rfc8259 JavaScript Object Notation
           */
          JSON,
      }
  }