[HHH-15259] Explicitly add JavaDoc to make @deprecated hint visible in Eclipse

Signed-off-by: Sven Strickroth <[email protected]>

Author: csware

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

@@ -1310,9 +1310,19 @@ interface LockRequest {
 	@Override
 	<R> Query<R> createQuery(CriteriaQuery<R> criteriaQuery);
 
-	@Override @Deprecated @SuppressWarnings("rawtypes")
+	/**
+	 * Create a {@link MutationQuery} for the given JPA {@link CriteriaDelete}
+	 *
+	 * @deprecated use {@link #createMutationQuery(CriteriaDelete)}
+	 */
+	@Override @Deprecated(since = "6.0") @SuppressWarnings("rawtypes")
 	Query createQuery(CriteriaDelete deleteQuery);
 
-	@Override @Deprecated @SuppressWarnings("rawtypes")
+	/**
+	 * Create a {@link MutationQuery} for the given JPA {@link CriteriaUpdate}
+	 *
+	 * @deprecated use {@link #createMutationQuery(CriteriaUpdate)}
+	 */
+	@Override @Deprecated(since = "6.0") @SuppressWarnings("rawtypes")
 	Query createQuery(CriteriaUpdate updateQuery);
 }