From 8e7b3a72ec46e72f6ad187b6c0aa391fa715bdc9 Mon Sep 17 00:00:00 2001
From: Gavin King <gavin@hibernate.org>
Date: Mon, 20 Oct 2025 17:47:32 +0200
Subject: [PATCH] make it clear that @Fetch(JOIN) always takes precedence over
 fetch=LAZY

---
 .../src/main/java/org/hibernate/annotations/Fetch.java         | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/hibernate-core/src/main/java/org/hibernate/annotations/Fetch.java b/hibernate-core/src/main/java/org/hibernate/annotations/Fetch.java
index 11ea83d33f1a..b0e6dcf0aa66 100644
--- a/hibernate-core/src/main/java/org/hibernate/annotations/Fetch.java
+++ b/hibernate-core/src/main/java/org/hibernate/annotations/Fetch.java
@@ -27,7 +27,8 @@
  * overridden in a given {@linkplain FetchProfile fetch profile}.
  * <p>
  * Note that join fetching is incompatible with lazy fetching, and so
- * {@code @Fetch(JOIN)} implies {@code fetch=EAGER}.
+ * {@code @Fetch(JOIN)} implies {@code fetch=EAGER}, overriding any
+ * explicitly-specified {@code fetch=LAZY} setting.
  *
  * @author Emmanuel Bernard
  *