src/java.se/share/data/jdwp/jdwp.spec

*** 1,7 ***
  /*
!  * Copyright (c) 1998, 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
--- 1,7 ---
  /*
!  * Copyright (c) 1998, 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.  Oracle designates this

*** 2505,11 ***
                          (int depth "relative call stack limit. "
                             "See <a href=\"#JDWP_StepDepth\">JDWP.StepDepth</a>")
                      )
                      (Alt InstanceOnly=11
                          "Restricts reported events to those whose "
!                         "active 'this' object is the given object. "
                          "Match value is the null object for static methods. "
                          "This modifier can be used with any event kind "
                          "except class prepare, class unload, thread start, "
                          "and thread end. Introduced in JDWP version 1.4."
  
--- 2505,12 ---
                          (int depth "relative call stack limit. "
                             "See <a href=\"#JDWP_StepDepth\">JDWP.StepDepth</a>")
                      )
                      (Alt InstanceOnly=11
                          "Restricts reported events to those whose "
!                         "active 'this' object is the given object "
+                         "as determined by applying the Java == operator. "
                          "Match value is the null object for static methods. "
                          "This modifier can be used with any event kind "
                          "except class prepare, class unload, thread start, "
                          "and thread end. Introduced in JDWP version 1.4."
  

*** 2597,10 ***
--- 2598,20 ---
          "Even if local variable information is not available, values can "
          "be retrieved if the front-end is able to "
          "determine the correct local variable index. (Typically, this "
          "index can be determined for method arguments from the method "
          "signature without access to the local variable table information.) "
+         "<p>"
+         "When preview features are enabled, "
+         "if a local variable is the 'this' object and represents a "
+         "value object under construction, the "
+         "value returned will be for a snapshot of the "
+         "value object, not a reference to the actual value object under "
+         "construction. Therefore the value returned will not reflect "
+         "changes to the value object that happen later on during "
+         "construction."
+         
          (Out
              (threadObject thread "The frame's thread. ")
              (frame frame "The frame ID. ")
              (Repeat slots "The number of values to get. "
                  (Group SlotInfo

*** 2668,10 ***
--- 2679,18 ---
      )
      (Command ThisObject=3
          "Returns the value of the 'this' reference for this frame. "
          "If the frame's method is static or native, the reply "
          "will contain the null object reference. "
+         "<p>"
+         "When preview features are enabled, "
+         "if 'this' represents a value object under construction, the "
+         "value returned will be for a snapshot of the "
+         "value object, not a reference to the actual value object under "
+         "construction. Therefore the value returned will not reflect "
+         "changes to the value object that happen later on during "
+         "construction."
          (Out
              (threadObject thread "The frame's thread. ")
              (frame frame "The frame ID. ")
          )
          (Reply