Polishing

spring-orm-hibernate4/src/main/java/org/springframework/orm/hibernate4/HibernateTransactionManager.java

@@ -81,12 +81,12 @@ import org.springframework.transaction.support.TransactionSynchronizationManager
  * transaction. The DataSource that Hibernate uses needs to be JTA-enabled in
  * such a scenario (see container setup).
  *
- * <p>On JDBC 3.0, this transaction manager supports nested transactions via JDBC 3.0
+ * <p>This transaction manager supports nested transactions via JDBC 3.0 Savepoints.
- * Savepoints. The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"}
+ * The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"} flag defaults
- * flag defaults to "false", though, as nested transactions will just apply to the
+ * to "false", though, as nested transactions will just apply to the JDBC Connection,
- * JDBC Connection, not to the Hibernate Session and its cached objects. You can
+ * not to the Hibernate Session and its cached entity objects and related context.
- * manually set the flag to "true" if you want to use nested transactions for
+ * You can manually set the flag to "true" if you want to use nested transactions
- * JDBC access code which participates in Hibernate transactions (provided that
+ * for JDBC access code which participates in Hibernate transactions (provided that
  * your JDBC driver supports Savepoints). <i>Note that Hibernate itself does not
  * support nested transactions! Hence, do not expect Hibernate access code to
  * semantically participate in a nested transaction.</i>

spring-orm/src/main/java/org/springframework/orm/hibernate3/HibernateTransactionManager.java

@@ -100,12 +100,12 @@ import org.springframework.transaction.support.TransactionSynchronizationManager
  * special restrictions with EJB CMT and restrictive JTA subsystems: See
  * {@link org.springframework.transaction.jta.JtaTransactionManager}'s javadoc for details.
  *
- * <p>On JDBC 3.0, this transaction manager supports nested transactions via JDBC 3.0
+ * <p>This transaction manager supports nested transactions via JDBC 3.0 Savepoints.
- * Savepoints. The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"}
+ * The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"} flag defaults
- * flag defaults to "false", though, as nested transactions will just apply to the
+ * to "false", though, as nested transactions will just apply to the JDBC Connection,
- * JDBC Connection, not to the Hibernate Session and its cached objects. You can
+ * not to the Hibernate Session and its cached entity objects and related context.
- * manually set the flag to "true" if you want to use nested transactions for
+ * You can manually set the flag to "true" if you want to use nested transactions
- * JDBC access code which participates in Hibernate transactions (provided that
+ * for JDBC access code which participates in Hibernate transactions (provided that
  * your JDBC driver supports Savepoints). <i>Note that Hibernate itself does not
  * support nested transactions! Hence, do not expect Hibernate access code to
  * semantically participate in a nested transaction.</i>

spring-orm/src/main/java/org/springframework/orm/jdo/JdoTransactionManager.java

@@ -73,10 +73,10 @@ import org.springframework.transaction.support.TransactionSynchronizationManager
  * that acts as "connectionFactory" of the PersistenceManagerFactory, so you usually
  * don't need to explicitly specify the "dataSource" property.
  *
- * <p>On JDBC 3.0, this transaction manager supports nested transactions via JDBC 3.0
+ * <p>This transaction manager supports nested transactions via JDBC 3.0 Savepoints.
- * Savepoints. The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"}
+ * The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"} flag defaults
- * flag defaults to "false", though, as nested transactions will just apply to the
+ * to "false", though, as nested transactions will just apply to the JDBC Connection,
- * JDBC Connection, not to the JDO PersistenceManager and its cached objects.
+ * not to the JDO PersistenceManager and its cached entity objects and related context.
  * You can manually set the flag to "true" if you want to use nested transactions
  * for JDBC access code which participates in JDO transactions (provided that your
  * JDBC driver supports Savepoints). <i>Note that JDO itself does not support

spring-orm/src/main/java/org/springframework/orm/jpa/JpaTransactionManager.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -85,10 +85,10 @@ import org.springframework.util.CollectionUtils;
  * used as known connection factory of the EntityManagerFactory, so you usually
  * don't need to explicitly specify the "dataSource" property.
  *
- * <p>On JDBC 3.0, this transaction manager supports nested transactions via JDBC 3.0
+ * <p>This transaction manager supports nested transactions via JDBC 3.0 Savepoints.
- * Savepoints. The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"}
+ * The {@link #setNestedTransactionAllowed} "nestedTransactionAllowed"} flag defaults
- * flag defaults to "false", though, as nested transactions will just apply to the
+ * to "false", though, as nested transactions will just apply to the JDBC Connection,
- * JDBC Connection, not to the JPA EntityManager and its cached objects.
+ * not to the JPA EntityManager and its cached entity objects and related context.
  * You can manually set the flag to "true" if you want to use nested transactions
  * for JDBC access code which participates in JPA transactions (provided that your
  * JDBC driver supports Savepoints). <i>Note that JPA itself does not support