From e266c0085ffe0b753d4b6732c3a01c4226c7febd Mon Sep 17 00:00:00 2001
From: Gavin King <gavin@hibernate.org>
Date: Tue, 18 Nov 2025 13:24:11 +0100
Subject: [PATCH] add some @links in the javadoc

---
 .../SynchronizationCallbackCoordinator.java              | 9 +++++----
 .../SynchronizationCallbackCoordinatorTrackingImpl.java  | 5 +++--
 .../transaction/spi/TransactionCoordinatorBuilder.java   | 2 +-
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinator.java b/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinator.java
index dc13968d8c0c..d44e6163e8cf 100644
--- a/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinator.java
+++ b/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinator.java
@@ -7,19 +7,20 @@
 import jakarta.transaction.Synchronization;
 
 /**
- * Manages funneling JTA Synchronization callbacks back into the Hibernate transaction engine.
+ * Funnels JTA {@link Synchronization} callbacks back into the Hibernate transaction engine.
  *
  * @author Steve Ebersole
  */
 public interface SynchronizationCallbackCoordinator extends Synchronization {
 	/**
-	 * Called by the TransactionCoordinator when it registers the Synchronization with the JTA system
+	 * Called by the JTA {@link org.hibernate.resource.transaction.spi.TransactionCoordinator}
+	 * when it registers the {@code Synchronization} with the JTA system.
 	 */
 	void synchronizationRegistered();
 
 	/**
-	 * Called by the TransactionCoordinator to allow the SynchronizationCallbackCoordinator to process any
-	 * after-completion handling that it may have delayed due to thread affinity
+	 * Called by the session to allow this {@link SynchronizationCallbackCoordinator} to
+	 * process any after completion handling that it has delayed due to thread affinity.
 	 */
 	void processAnyDelayedAfterCompletion();
 }
diff --git a/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinatorTrackingImpl.java b/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinatorTrackingImpl.java
index a955044ff01a..3cb033d5638c 100644
--- a/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinatorTrackingImpl.java
+++ b/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jta/internal/synchronization/SynchronizationCallbackCoordinatorTrackingImpl.java
@@ -11,8 +11,9 @@
 import static org.hibernate.resource.transaction.backend.jta.internal.JtaLogging.JTA_LOGGER;
 
 /**
- * Extension of SynchronizationCallbackCoordinatorNonTrackingImpl that adds checking of whether a rollback comes from
- * a thread other than the application thread (thread used to register the Synchronization)
+ * Extension of {@link SynchronizationCallbackCoordinatorNonTrackingImpl} that adds
+ * checking of whether a rollback comes from a thread other than the application
+ * thread (thread used to register the {@code Synchronization})
  *
  * @author Steve Ebersole
  * @author Brett Meyer
diff --git a/hibernate-core/src/main/java/org/hibernate/resource/transaction/spi/TransactionCoordinatorBuilder.java b/hibernate-core/src/main/java/org/hibernate/resource/transaction/spi/TransactionCoordinatorBuilder.java
index 623065d2ccc9..6fdf928ca807 100644
--- a/hibernate-core/src/main/java/org/hibernate/resource/transaction/spi/TransactionCoordinatorBuilder.java
+++ b/hibernate-core/src/main/java/org/hibernate/resource/transaction/spi/TransactionCoordinatorBuilder.java
@@ -25,7 +25,7 @@ public interface TransactionCoordinatorBuilder extends Service {
 	interface Options {
 		/**
 		 * Indicates whether an active transaction should be automatically joined.  Only relevant
-		 * for JTA-based TransactionCoordinator instances.
+		 * for JTA-based {@link TransactionCoordinator} instances.
 		 *
 		 * @return {@code true} indicates the active transaction should be auto joined; {@code false}
 		 * indicates it should not (until {@link TransactionCoordinator#explicitJoin} is called).