HHH-14563 Remove a few obsolete references to DOM4J entity-mode

This mode was removed literally a decade ago.

hibernate-core/src/main/java/org/hibernate/annotations/Tuplizer.java

@@ -31,7 +31,7 @@ public @interface Tuplizer {
 	Class impl();
 
 	/**
-	 * either pojo, dynamic-map or dom4j.
+	 * either pojo or dynamic-map.
 	 * @deprecated should use #entityModeType instead
 	 */
 	@Deprecated

hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/AttributeSource.java

@@ -35,7 +35,8 @@ public interface AttributeSource extends ToolingHintContextContainer {
 	public boolean isSingular();
 
 	/**
-	 * Ugh.  This is the deprecated DOM4J entity-mode feature
+	 * This is only useful to log warnings when these deprecated attributes are populated.
+	 * It was only useful for DOM4J entity-mode, which was removed a long time ago.
 	 *
 	 * @return The xml node name
 	 */

hibernate-core/src/main/java/org/hibernate/internal/log/DeprecationLogger.java

@@ -53,7 +53,8 @@ public interface DeprecationLogger extends BasicLogger {
 	public void logDeprecationOfMultipleEntityModeSupport();
 
 	/**
-	 * Log message indicating the use of DOM4J EntityMode.
+	 * Log message indicating the use of features that were only useful for DOM4J EntityMode,
+	 * which was removed a long time ago.
 	 */
 	@LogMessage( level = WARN )
 	@Message(

hibernate-core/src/main/java/org/hibernate/tuple/Tuplizer.java

@@ -27,10 +27,6 @@ import org.hibernate.property.access.spi.Getter;
  * <li>extract and inject values through getters/setter, or by direct field access, etc
  * </ul>
  * </p>
- * That same piece of data might also be represented as a DOM structure, using
- * the tuplizer associated with the DOM4J entity-mode, which would generate instances
- * of {@link org.dom4j.Element} as the data structure and know how to access the
- * values as either nested {@link org.dom4j.Element}s or as {@link org.dom4j.Attribute}s.
  *
  * @see org.hibernate.tuple.entity.EntityTuplizer
  * @see org.hibernate.tuple.component.ComponentTuplizer

hibernate-core/src/main/java/org/hibernate/type/CollectionType.java

@@ -576,7 +576,6 @@ public abstract class CollectionType extends AbstractType implements Association
 			Object owner,
 			Map copyCache,
 			SharedSessionContractImplementor session) {
-		// TODO: does not work for EntityMode.DOM4J yet!
 		java.util.Collection result = ( java.util.Collection ) target;
 		result.clear();