add some missing package descriptors

and mark two packages @deprecated

Author: gavinking

hibernate-core/src/main/java/org/hibernate/dialect/hint/package-info.java

@@ -4,6 +4,7 @@
  */
 
 /**
- * @deprecated Moved to {@link org.hibernate.dialect.Dialect}
+ * @apiNote Moved to {@link org.hibernate.dialect.Dialect}
  */
+@Deprecated(forRemoval = true)
 package org.hibernate.dialect.hint;

hibernate-core/src/main/java/org/hibernate/mapping/package-info.java

@@ -26,7 +26,7 @@
  * <li>It is the responsibility of the metadata binders in the package
  *     {@link org.hibernate.boot.model.internal} to process a set of
  *     annotated classes and produce fully-initialized mapping model
- *     objects. This is in itself a complicated multi-phase process,
+ *     objects. This is in itself a complicated multiphase process,
  *     since, for example, the type of an association mapping in one
  *     entity cannot be fully assigned until the target entity has
  *     been processed.

hibernate-core/src/main/java/org/hibernate/query/range/package-info.java

@@ -0,0 +1,15 @@
+/*
+ * SPDX-License-Identifier: Apache-2.0
+ * Copyright Red Hat Inc. and Hibernate Authors
+ */
+/**
+ * The {@link org.hibernate.query.range.Range} framework.
+ *
+ * @see org.hibernate.query.range.Range
+ *
+ * @since 7
+ */
+@Incubating
+package org.hibernate.query.range;
+
+import org.hibernate.Incubating;

hibernate-core/src/main/java/org/hibernate/query/restriction/package-info.java

@@ -0,0 +1,16 @@
+/*
+ * SPDX-License-Identifier: Apache-2.0
+ * Copyright Red Hat Inc. and Hibernate Authors
+ */
+/**
+ * The {@link org.hibernate.query.restriction.Restriction} framework.
+ *
+ * @see org.hibernate.query.restriction.Restriction
+ * @see org.hibernate.query.restriction.Path
+ *
+ * @since 7
+ */
+@Incubating
+package org.hibernate.query.restriction;
+
+import org.hibernate.Incubating;

hibernate-core/src/main/java/org/hibernate/tuple/package-info.java

@@ -6,10 +6,11 @@
 /**
  * Most contracts here have been replaced by the new runtime
  * {@linkplain org.hibernate.metamodel.mapping mapping model}.
- * <p>
- * @apiNote This entire package (and sub-packages) is considered deprecated
+ *
+ * @apiNote This entire package (and subpackages) is considered
+ *          deprecated and will be removed
  */
-@Remove
+@Remove @Deprecated(forRemoval = true)
 package org.hibernate.tuple;
 
 import org.hibernate.Remove;

hibernate-core/src/main/java/org/hibernate/type/descriptor/java/spi/package-info.java

@@ -0,0 +1,8 @@
+/*
+ * SPDX-License-Identifier: Apache-2.0
+ * Copyright Red Hat Inc. and Hibernate Authors
+ */
+/**
+ * SPIs related to {@link org.hibernate.type.descriptor.java.JavaType}.
+ */
+package org.hibernate.type.descriptor.java.spi;

hibernate-core/src/main/java/org/hibernate/type/descriptor/jdbc/spi/package-info.java

@@ -0,0 +1,8 @@
+/*
+ * SPDX-License-Identifier: Apache-2.0
+ * Copyright Red Hat Inc. and Hibernate Authors
+ */
+/**
+ * SPIs related to {@link org.hibernate.type.descriptor.jdbc.JdbcType}.
+ */
+package org.hibernate.type.descriptor.jdbc.spi;