HHH-16302 Document that TimeZoneStorageType.NORMALIZE normalizes to the JVM timezone, not to hibernate.jdbc.time_zone, upon reading values

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

@@ -28,7 +28,18 @@ public enum TimeZoneStorageStrategy {
 	 */
 	COLUMN,
 	/**
-	 * Doesn't store the time zone, but instead normalizes to the JDBC timezone.
+	 * Does not store the time zone, and instead:
+	 * <ul>
+	 * <li>when persisting to the database, normalizes JDBC timestamps to the
+	 * {@linkplain org.hibernate.cfg.AvailableSettings#JDBC_TIME_ZONE}
+	 * or to the JVM default time zone otherwise.
+	 * <li>when reading back from the database, sets the offset or zone
+	 * of {@code OffsetDateTime}/{@code ZonedDateTime} properties
+	 * to the JVM default time zone.
+	 * </ul>
+	 * <p>
+	 * Provided partly for backward compatibility with older
+	 * versions of Hibernate.
 	 */
 	NORMALIZE,
 	/**

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

@@ -78,15 +78,16 @@ public enum TimeZoneStorageType {
 	/**
 	 * Does not store the time zone, and instead:
 	 * <ul>
-	 * <li>normalizes JDBC timestamps to the
+	 * <li>when persisting to the database, normalizes JDBC timestamps to the
-	 *     {@linkplain org.hibernate.cfg.AvailableSettings#JDBC_TIME_ZONE
+	 * {@linkplain org.hibernate.cfg.AvailableSettings#JDBC_TIME_ZONE}
-	 *     JDBC timezone}, if set, or
+	 * or to the JVM default time zone if not set.
-	 * <li>passes them through in the JVM default time zone
+	 * <li>when reading back from the database, sets the offset or zone
-	 *    otherwise.
+	 * of {@code OffsetDateTime}/{@code ZonedDateTime} values
+	 * to the JVM default time zone.
 	 * </ul>
 	 * <p>
 	 * Provided partly for backward compatibility with older
-	 * versions of Hibernate
+	 * versions of Hibernate.
 	 */
 	NORMALIZE,
 	/**