HHH-15977 - Deprecate @Persister

documentation/src/main/asciidoc/userguide/chapters/domain/entity.adoc

@@ -500,6 +500,11 @@ For entities, the custom persister must implement the https://docs.jboss.org/hib
 
 For collections, the custom persister must implement the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/persister/collection/CollectionPersister.html[`CollectionPersister`] interface.
 
+NOTE: Supplying a custom persister has been allowed historically, but has never been fully supported.
+Hibernate 6 provides better, alternative ways to accomplish the use cases for a custom persister.  As
+of 6.2 `@Persister` has been formally deprecated.
+
+
 [[entity-persister-mapping]]
 .Entity persister mapping
 ====
@@ -515,4 +520,4 @@ include::{sourcedir-persister}/Book.java[tag=entity-persister-mapping,indent=0]
 ====
 
 By providing your own `EntityPersister` and `CollectionPersister` implementations,
-you can control how entities and collections are persisted into the database.
+you can control how entities and collections are persisted into the database.

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

@@ -18,9 +18,12 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
  * Specify a custom persister.
  *
  * @author Shawn Clowater
+ *
+ * @deprecated Alternative depends on reason for custom persister
  */
 @Target({TYPE, METHOD, FIELD})
 @Retention(RUNTIME)
+@Deprecated( since = "6" )
 public @interface Persister {
 	/**
 	 * The custom persister class.