src/hotspot/share/prims/jvmti.xml

@@ -1,9 +1,9 @@
  <?xml version="1.0" encoding="UTF-8"?>
  <?xml-stylesheet type="text/xsl" href="jvmti.xsl"?>
  <!--
-  Copyright (c) 2002, 2025, Oracle and/or its affiliates. All rights reserved.
+  Copyright (c) 2002, 2026, 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.

@@ -5886,10 +5886,13 @@
          </param>
          <param id="value_ptr">
            <outptr><jobject/></outptr>
              <description>
                On return, points to the variable's value.
+               If the frame's method is a value object constructor and
+               the requested local is the "<code>this</code>" object, the
+               value_ptr is set to a snapshot of the "<code>this</code>" object.
              </description>
          </param>
        </parameters>
        <errors>
          <error id="JVMTI_ERROR_INVALID_SLOT">

@@ -5939,10 +5942,12 @@
          </param>
          <param id="value_ptr">
            <outptr><jobject/></outptr>
              <description>
                On return, points to the variable's value.
+               If the frame's method is a value object constructor, the 
+               value_ptr is set to a snapshot of the "<code>this</code>" object.
              </description>
          </param>
        </parameters>
        <errors>
          <error id="JVMTI_ERROR_INVALID_SLOT">