Fix and improve Javadoc in spring-tx

Closes gh-28794

Author: marcwrobel

spring-tx/src/main/java/org/springframework/dao/CleanupFailureDataAccessException.java

@@ -17,14 +17,14 @@
 package org.springframework.dao;
 
 /**
- * Exception thrown when we couldn't cleanup after a data access operation,
+ * Exception thrown when we couldn't clean up after a data access operation,
  * but the actual operation went OK.
  *
  * <p>For example, this exception or a subclass might be thrown if a JDBC
  * Connection couldn't be closed after it had been used successfully.
  *
  * <p>Note that data access code might perform resources cleanup in a
- * finally block and therefore log cleanup failure rather than rethrow it,
+ * {@code finally} block and therefore log cleanup failure rather than rethrow it,
  * to keep the original data access exception, if any.
  *
  * @author Rod Johnson

spring-tx/src/main/java/org/springframework/dao/DataAccessException.java

@@ -27,7 +27,7 @@
  *
  * <p>This exception hierarchy aims to let user code find and handle the
  * kind of error encountered without knowing the details of the particular
- * data access API in use (e.g. JDBC). Thus it is possible to react to an
+ * data access API in use (e.g. JDBC). Thus, it is possible to react to an
  * optimistic locking failure without knowing that JDBC is being used.
  *
  * <p>As this class is a runtime exception, there is no need for user code
@@ -50,7 +50,7 @@ public DataAccessException(String msg) {
 	/**
 	 * Constructor for DataAccessException.
 	 * @param msg the detail message
-	 * @param cause the root cause (usually from using a underlying
+	 * @param cause the root cause (usually from using an underlying
 	 * data access API such as JDBC)
 	 */
 	public DataAccessException(@Nullable String msg, @Nullable Throwable cause) {

spring-tx/src/main/java/org/springframework/dao/DuplicateKeyException.java

@@ -18,7 +18,7 @@
 
 /**
  * Exception thrown when an attempt to insert or update data
- * results in violation of an primary key or unique constraint.
+ * results in violation of a primary key or unique constraint.
  * Note that this is not necessarily a purely relational concept;
  * unique primary keys are required by most database types.
  *

spring-tx/src/main/java/org/springframework/dao/NonTransientDataAccessException.java

@@ -41,7 +41,7 @@ public NonTransientDataAccessException(String msg) {
 	/**
 	 * Constructor for NonTransientDataAccessException.
 	 * @param msg the detail message
-	 * @param cause the root cause (usually from using a underlying
+	 * @param cause the root cause (usually from using an underlying
 	 * data access API such as JDBC)
 	 */
 	public NonTransientDataAccessException(@Nullable String msg, @Nullable Throwable cause) {

spring-tx/src/main/java/org/springframework/dao/RecoverableDataAccessException.java

@@ -41,7 +41,7 @@ public RecoverableDataAccessException(String msg) {
 	/**
 	 * Constructor for RecoverableDataAccessException.
 	 * @param msg the detail message
-	 * @param cause the root cause (usually from using a underlying
+	 * @param cause the root cause (usually from using an underlying
 	 * data access API such as JDBC)
 	 */
 	public RecoverableDataAccessException(String msg, Throwable cause) {

spring-tx/src/main/java/org/springframework/dao/TransientDataAccessException.java

@@ -41,7 +41,7 @@ public TransientDataAccessException(String msg) {
 	/**
 	 * Constructor for TransientDataAccessException.
 	 * @param msg the detail message
-	 * @param cause the root cause (usually from using a underlying
+	 * @param cause the root cause (usually from using an underlying
 	 * data access API such as JDBC)
 	 */
 	public TransientDataAccessException(String msg, @Nullable Throwable cause) {

spring-tx/src/main/java/org/springframework/dao/support/PersistenceExceptionTranslationInterceptor.java

@@ -99,7 +99,7 @@ public void setPersistenceExceptionTranslator(PersistenceExceptionTranslator pet
 	 * raw exception when declared, i.e. when the originating method signature's exception
 	 * declarations allow for the raw exception to be thrown ("false").
 	 * <p>Default is "false". Switch this flag to "true" in order to always translate
-	 * applicable exceptions, independent from the originating method signature.
+	 * applicable exceptions, independent of the originating method signature.
 	 * <p>Note that the originating method does not have to declare the specific exception.
 	 * Any base class will do as well, even {@code throws Exception}: As long as the
 	 * originating method does explicitly declare compatible exceptions, the raw exception

spring-tx/src/main/java/org/springframework/jca/endpoint/GenericMessageEndpointFactory.java

@@ -35,7 +35,7 @@
  * {@link javax.resource.spi.endpoint.MessageEndpointFactory} interface,
  * providing transaction management capabilities for any kind of message
  * listener object (e.g. {@link javax.jms.MessageListener} objects or
- * {@link javax.resource.cci.MessageListener} objects.
+ * {@link javax.resource.cci.MessageListener} objects).
  *
  * <p>Uses AOP proxies for concrete endpoint instances, simply wrapping
  * the specified message listener object and exposing all of its implemented

spring-tx/src/main/java/org/springframework/jca/endpoint/GenericMessageEndpointManager.java

@@ -240,9 +240,9 @@ public boolean isAutoStartup() {
 	/**
 	 * Specify the phase in which this endpoint manager should be started
 	 * and stopped. The startup order proceeds from lowest to highest, and
-	 * the shutdown order is the reverse of that. By default this value is
-	 * Integer.MAX_VALUE meaning that this endpoint manager starts as late
-	 * as possible and stops as soon as possible.
+	 * the shutdown order is the reverse of that. By default, this value is
+	 * {@code Integer.MAX_VALUE} meaning that this endpoint manager starts
+	 * as late as possible and stops as soon as possible.
 	 */
 	public void setPhase(int phase) {
 		this.phase = phase;

spring-tx/src/main/java/org/springframework/transaction/SavepointManager.java

@@ -26,7 +26,7 @@
  * else, a subtransaction with PROPAGATION_NESTED is preferable.
  *
  * <p>This interface is inspired by JDBC 3.0's Savepoint mechanism
- * but is independent from any specific persistence technology.
+ * but is independent of any specific persistence technology.
  *
  * @author Juergen Hoeller
  * @since 1.1