add some @links in the javadoc

Author: gavinking

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();
 }

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

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).