From a340a677b5c17b0e598af5bbaa9a6f48d42af231 Mon Sep 17 00:00:00 2001
From: Chen Liang <chen.l.liang@oracle.com>
Date: Mon, 27 Jul 2026 10:03:55 -0500
Subject: [PATCH 1/2] Add vbc warning for Reference

---
 .../share/classes/java/lang/doc-files/ValueBased.html       | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/src/java.base/share/classes/java/lang/doc-files/ValueBased.html b/src/java.base/share/classes/java/lang/doc-files/ValueBased.html
index 3b860ce0534fd..e2500051be9f5 100644
--- a/src/java.base/share/classes/java/lang/doc-files/ValueBased.html
+++ b/src/java.base/share/classes/java/lang/doc-files/ValueBased.html
@@ -1,6 +1,6 @@
 <!doctype html>
 <!--
- Copyright (c) 2013, 2024, Oracle and/or its affiliates. All rights reserved.
+ Copyright (c) 2013, 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
@@ -65,6 +65,10 @@ <h1 id="ValueBased">{@index "Value-based Classes"}</h1>
     because the programmer cannot guarantee exclusive ownership of the
     associated monitor.</p>
 
+<p>Use of instances of value-based classes in {@linkplain
+    java.lang.ref.Reference reference objects} is strongly discouraged,
+    because these instances do not have reliable identity.</p>
+
 <p>Identity-related behavior of value-based classes may change in a future release.
     For example, synchronization may fail.</p>
 

From 6422ae641ee192ae310df7ccd07bb82c34fedff5 Mon Sep 17 00:00:00 2001
From: Chen Liang <chen.l.liang@oracle.com>
Date: Mon, 27 Jul 2026 15:05:43 -0500
Subject: [PATCH 2/2] "referent"

---
 src/java.base/share/classes/java/lang/doc-files/ValueBased.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/java.base/share/classes/java/lang/doc-files/ValueBased.html b/src/java.base/share/classes/java/lang/doc-files/ValueBased.html
index e2500051be9f5..0bdcf70df3a77 100644
--- a/src/java.base/share/classes/java/lang/doc-files/ValueBased.html
+++ b/src/java.base/share/classes/java/lang/doc-files/ValueBased.html
@@ -65,7 +65,7 @@ <h1 id="ValueBased">{@index "Value-based Classes"}</h1>
     because the programmer cannot guarantee exclusive ownership of the
     associated monitor.</p>
 
-<p>Use of instances of value-based classes in {@linkplain
+<p>Use of instances of value-based classes as referents in {@linkplain
     java.lang.ref.Reference reference objects} is strongly discouraged,
     because these instances do not have reliable identity.</p>
 
