Summary

This CSR covers a missing @throws in the StableValue docs.

Problem

A @throws was missing in the StableValue docs.

Solution

Update the specifications to include the @throws

Specification

diff --git a/src/java.base/share/classes/java/lang/StableValue.java b/src/java.base/share/classes/java/lang/StableValue.java
index b12d6f5e92128..4abcafd13b493 100644
--- a/src/java.base/share/classes/java/lang/StableValue.java
+++ b/src/java.base/share/classes/java/lang/StableValue.java
@@ -519,6 +515,9 @@ public sealed interface StableValue
      *
      * @param contents to set
      * @throws IllegalStateException if the contents was already set
+     * @throws IllegalStateException if a supplier invoked by {@link #orElseSet(Supplier)}
+     *         recursively attempts to set this stable value by calling this method
+     *         directly or indirectly.
      */
     void setOrThrow(T contents);