Javadoc cleanup

hibernate-core/hibernate-core.gradle

@@ -264,6 +264,7 @@ tasks.withType( Test.class ).each { test ->
 tasks.named( "javadoc", Javadoc ) {
     configure(options) {
         overview = rootProject.file( "shared/javadoc/overview.html" )
+        exclude( "**/internal/**", "org/hibernate/boot/jaxb/**", "org/hibernate/tuple/**" )
     }
 }
 

hibernate-core/src/main/java/org/hibernate/annotations/processing/Find.java

@@ -169,7 +169,7 @@
  * </ul>
  * <p>
  * Finally, a method might have a parameter of type
- * {@link org.hibernate.query.restriction.Restriction Restriction<? super E>},
+ * {@link org.hibernate.query.restriction.Restriction Restriction&lt;? super E&gt;},
  * allowing the caller to apply an arbitrary filtering criterion to
  * the query results.
  * <p>

hibernate-core/src/main/java/org/hibernate/annotations/processing/HQL.java

@@ -135,7 +135,7 @@
  * </ul>
  * <p>
  * Finally, a method might have a parameter of type
- * {@link org.hibernate.query.restriction.Restriction Restriction<? super E>},
+ * {@link org.hibernate.query.restriction.Restriction Restriction&lt;? super E&gt;},
  * allowing the caller to apply an arbitrary filtering criterion to
  * the query results.
  * <p>

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;