improve javadoc of TransientObjectException

Author: gavinking

hibernate-core/src/main/java/org/hibernate/TransientObjectException.java

@@ -5,8 +5,20 @@
 package org.hibernate;
 
 /**
- * Thrown when the user passes a transient instance to a {@link Session}
- * method that expects a persistent instance.
+ * Thrown if a transient instance of an entity class is passed to
+ * a {@link Session} method that expects a persistent instance,
+ * or if the state of an entity instance cannot be made persistent
+ * because the instance holds a reference to a transient entity.
+ * <p>
+ * An entity is considered <em>transient</em> if it is:
+ * <ul>
+ * <li>a newly-instantiated instance of an entity class which has
+ *    never been {@linkplain Session#persist made persistent} in
+ *    the database, or
+ * <li>an entity instance previously associated with a persistence
+ *     context which has been {@linkplain Session#remove removed}
+ *     from the database.
+ * </ul>
  *
  * @author Gavin King
  */

hibernate-core/src/main/java/org/hibernate/TransientPropertyValueException.java

@@ -7,8 +7,18 @@
 import static org.hibernate.internal.util.StringHelper.qualify;
 
 /**
- * Thrown when a property cannot be persisted because it is an association
- * with a transient unsaved entity instance.
+ * Thrown when the state of an entity cannot be made persistent
+ * because the entity holds a reference to a transient entity.
+ * <p>
+ * An entity is considered <em>transient</em> if it is:
+ * <ul>
+ * <li>a newly-instantiated instance of an entity class which has
+ *    never been {@linkplain Session#persist made persistent} in
+ *    the database, or
+ * <li>an entity instance previously associated with a persistence
+ *     context which has been {@linkplain Session#remove removed}
+ *     from the database.
+ * </ul>
  *
  * @author Gail Badner
  */