review: clarify the use of annotation @JvmtiMountTransition in yield/…

…yield0
sspitsyn · Oct 18, 2024 · 94862c3 · 94862c3
1 parent f8d0515
commit 94862c3
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/src/java.base/share/classes/jdk/internal/vm/annotation/JvmtiMountTransition.java b/src/java.base/share/classes/jdk/internal/vm/annotation/JvmtiMountTransition.java
@@ -30,6 +30,9 @@
 /**
  * A method is annotated as "jvmti mount transition" if it starts
  * or ends virtual thread mount state transition (VTMS transition).
+ * The Continuation yield and yield0 frames normally are in VTMS transition
+ * but can be found out of transition in an unmounted virtual thread.
+ * This inconsistency is the reason why they also need this annotation.
  *
  * @implNote
  * This annotation is only used for some VirtualThread and Continuation methods.