HHH-10303 - Reinstate legacy bytecode-enhancement Ant task

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

@@ -208,5 +208,13 @@ public interface DeprecationLogger extends BasicLogger {
 //	)
 //	void logDeprecatedBytecodeEnhancement();
 
+	@LogMessage(level = WARN)
+	@Message(
+			id = 90000020,
+			value = "You are using the deprecated legacy bytecode enhancement Ant-task.  This task is left in place for a short-time to " +
+					"aid migrations to 5.1 and the new (vastly improved) bytecode enhancement support.  This task (%s) now delegates to the" +
+					"new Ant-task (%s) leveraging that new bytecode enhancement.  You should update your build to use the new task explicitly."
+	)
+	void logDeprecatedInstrumentTask(Class taskClass, Class newTaskClass);
 
 }

hibernate-core/src/main/java/org/hibernate/tool/instrument/javassist/InstrumentTask.java

@@ -0,0 +1,34 @@
+/*
+ * Hibernate, Relational Persistence for Idiomatic Java
+ *
+ * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
+ * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
+ */
+package org.hibernate.tool.instrument.javassist;
+
+import org.hibernate.internal.log.DeprecationLogger;
+import org.hibernate.tool.enhance.EnhancementTask;
+
+/**
+ * This is the legacy Ant-task Hibernate provided historically to
+ * perform its old-school bytecode instrumentation.  That has been replaced wholesale
+ * with a new approach to bytecode manipulation offering 3 build-time variations for Ant,
+ * Maven and Gradle.
+ *
+ * @author Muga Nishizawa
+ * @author Steve Ebersole
+ *
+ * @deprecated This is the legacy Ant-task Hibernate provided historically to
+ * perform its old-school bytecode instrumentation.  That has been replaced wholesale
+ * with a new approach to bytecode manipulation offering 3 build-time variations for Ant,
+ * Maven and Gradle.
+ *
+ * @see EnhancementTask
+ */
+@Deprecated
+@SuppressWarnings("unused")
+public class InstrumentTask extends EnhancementTask {
+	public InstrumentTask() {
+		DeprecationLogger.DEPRECATION_LOGGER.logDeprecatedInstrumentTask( InstrumentTask.class, EnhancementTask.class );
+	}
+}