HHH-19894 : Use Java 25 for building

Author: sebersole

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

@@ -14,36 +14,32 @@
 import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
-/**
- * A simplified way to specify the type of the discriminator in an {@link Any}
- * mapping, using the JPA-defined {@link DiscriminatorType}. This annotation
- * must be used in combination with {@link jakarta.persistence.Column} to fully
- * describe the discriminator column for an {@code @Any} relationship.
- * <p>
- * {@code @AnyDiscriminator} is quite similar to
- * {@link jakarta.persistence.DiscriminatorColumn#discriminatorType()} in
- * single-table inheritance mappings, but it describes a discriminator held
- * along with the foreign key in the referring side of a discriminated
- * relationship.
- * <p>
- * This annotation may be used in conjunction with {@link JdbcType} or
- * {@link JdbcTypeCode} to more precisely specify the type mapping. On the
- * other hand, {@link JdbcType} or {@link JdbcTypeCode} may be used without
- * {@code @AnyDiscriminator}.
- *
- * @see Any
- * @see AnyDiscriminatorValue
- * @see AnyDiscriminatorImplicitValues
- *
- * @since 6.0
- */
+/// A simplified way to specify the type of the discriminator in an [Any]
+/// mapping, using the JPA-defined [DiscriminatorType]. This annotation
+/// must be used in combination with [jakarta.persistence.Column] to fully
+/// describe the discriminator column for an `@Any` relationship.
+///
+/// `@AnyDiscriminator` is quite similar to
+/// [jakarta.persistence.DiscriminatorColumn#discriminatorType()] in
+/// single-table inheritance mappings, but it describes a discriminator held
+/// along with the foreign key in the referring side of a discriminated
+/// relationship.
+///
+/// This annotation may be used in conjunction with [JdbcType] or
+/// [JdbcTypeCode] to more precisely specify the type mapping. On the
+/// other hand, [JdbcType] or [JdbcTypeCode] may be used without
+/// `@AnyDiscriminator`.
+///
+/// @see Any
+/// @see AnyDiscriminatorValue
+/// @see AnyDiscriminatorImplicitValues
+///
+/// @since 6.0
 @Target({METHOD, FIELD, ANNOTATION_TYPE})
 @Retention( RUNTIME )
 public @interface AnyDiscriminator {
-	/**
-	 * The type of the discriminator, as a JPA {@link DiscriminatorType}.
-	 * For more precise specification of the type, use {@link JdbcType}
-	 * or {@link JdbcTypeCode}.
-	 */
+	/// The type of the discriminator, as a JPA [DiscriminatorType].
+	/// For more precise specification of the type, use [JdbcType]
+	/// or [JdbcTypeCode].
 	DiscriminatorType value() default DiscriminatorType.STRING;
 }

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

@@ -13,23 +13,20 @@
 import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
-/**
- * Specifies the maximum length of a SQL array type mapped by
- * the annotated attribute.
- * <p>
- * For example:
- * <pre>
- * {@code @Array(length=100)} // the maximum length of the SQL array
- * {@code @Column(length=64)} // the maximum length of the strings in the array
- * String[] strings;
- * </pre>
- */
+/// Specifies the maximum length of a SQL array type mapped by
+/// the annotated attribute.
+///
+/// For example:
+///
+/// ```java
+/// @Array(length=100) // the maximum length of the SQL array
+/// @Column(length=64) // the maximum length of the strings in the array
+/// String[] strings;
+/// ```
 @Incubating
 @Target({FIELD, METHOD})
 @Retention( RUNTIME )
 public @interface Array {
-	/**
-	 * The maximum length of the array.
-	 */
+	/// The maximum length of the array.
 	int length();
 }