additional clean up of - "massive" cleanout of the transformers stuff

hibernate-core/src/main/java/org/hibernate/query/Query.java

@@ -131,6 +131,8 @@ public interface Query<R> extends TypedQuery<R>, CommonQueryContract {
 	 * by default each result in the list is packaged in an array of type
 	 * {@code Object[]}.
 	 *
+	 * @implNote Delegates to {@link #list()}
+	 *
 	 * @return the results as a list
 	 */
 	default List<R> getResultList() {
@@ -146,6 +148,10 @@ public interface Query<R> extends TypedQuery<R>, CommonQueryContract {
 	 * The client should call {@link Stream#close()} after processing the
 	 * stream so that resources are freed as soon as possible.
 	 *
+	 * @implNote Delegates to {@link #stream()}, which in turn delegates
+	 * to this method.  Implementors should implement at least one of
+	 * these methods.
+	 *
 	 * @return The results as a {@link Stream}
 	 */
 	default Stream<R> getResultStream() {
@@ -217,6 +223,10 @@ public interface Query<R> extends TypedQuery<R>, CommonQueryContract {
 	 *
 	 * @return The results as a {@link Stream}
 	 *
+	 * @implNote Delegates to {@link #getResultStream()}, which in turn
+	 * delegates to this method.  Implementors should implement at least
+	 * one of these methods.
+	 *
 	 * @since 5.2
 	 */
 	default Stream<R> stream() {

hibernate-core/src/main/java/org/hibernate/query/ResultListTransformer.java

@@ -8,16 +8,21 @@ package org.hibernate.query;
 
 import java.util.List;
 
+import org.hibernate.Incubating;
+
 /**
- * Defines some processing performed on the result {@link List} of a
+ * Defines some processing performed on the overall result {@link List}
- * {@link org.hibernate.Query} before the result list is returned to
+ * of a {@link Query} before the result list is returned to the caller.
- * the caller of {@link org.hibernate.Query#getResultList()}.
  *
- * @see org.hibernate.transform.ResultTransformer
+ * @see Query#setResultListTransformer
+ * @see Query#list
+ * @see Query#getResultList
+ * @see TupleTransformer
  *
  * @author Steve Ebersole
  * @author Gavin King
  */
+@Incubating
 @FunctionalInterface
 public interface ResultListTransformer<T> {
 	/**

hibernate-core/src/main/java/org/hibernate/query/TupleTransformer.java

@@ -6,28 +6,32 @@
  */
 package org.hibernate.query;
 
+import org.hibernate.Incubating;
 import org.hibernate.sql.results.internal.RowTransformerTupleTransformerAdapter;
 
 import java.util.List;
 
 /**
- * Defines some transformation applied to each result of a {@link org.hibernate.Query}
+ * Defines some transformation applied to each result of a {@link Query}
- * before the results are packaged as a {@link List} and returned to the caller of
+ * before the results are packaged as a {@link List} and returned to the caller.  Each result
- * {@link org.hibernate.Query#getResultList()}. Each query result is received as a
+ * is received as a tuple (that is, as an {@code Object[]}), and may be transformed to
- * tuple, that is, as an array of type {@code Object[]}, and may be transformed to
  * some other type.
- * <p>
+ *
- * Every {@code TupleTransformer} is automatically wrapped in an instance of
+ * @implNote Every {@code TupleTransformer} is automatically wrapped in an instance of
  * {@link RowTransformerTupleTransformerAdapter}, adapting it to the
  * {@link org.hibernate.sql.results.spi.RowTransformer} contract, which is always
  * used to actually process the results internally.
  *
- * @see org.hibernate.transform.ResultTransformer
+ * @see Query#setTupleTransformer
+ * @see Query#list
+ * @see Query#getResultList
+ * @see ResultListTransformer
  * @see org.hibernate.sql.results.spi.RowTransformer
  *
  * @author Steve Ebersole
  * @author Gavin King
  */
+@Incubating
 @FunctionalInterface
 public interface TupleTransformer<T> {
 	/**

hibernate-core/src/main/java/org/hibernate/transform/ResultTransformer.java

@@ -21,7 +21,7 @@ import org.hibernate.query.TupleTransformer;
  *
  * @author Gavin King
  *
- * @deprecated Use {@link TupleTransformer} and/or {@link ResultListTransformer}
+ * @deprecated (since 6.0) Use {@link TupleTransformer} and/or {@link ResultListTransformer} instead
  */
 @Deprecated
 public interface ResultTransformer<T> extends TupleTransformer<T>, ResultListTransformer<T>, Serializable {