HHH-5467 - API documentation for @Fetch(SUBSELECT) is ambiguous.

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

@@ -14,15 +14,15 @@ package org.hibernate.annotations;
  */
 public enum FetchMode {
 	/**
-	 * use a secondary select for each individual entity, collection, or join load.
+	 * Use a secondary select for each individual entity, collection, or join load.
 	 */
 	SELECT,
 	/**
-	 * use an outer join to load the related entities, collections or joins.
+	 * Use an outer join to load the related entities, collections or joins.
 	 */
 	JOIN,
 	/**
-	 * use a secondary select so that, for a given collection, it can load all child entities associated with every parent table record using a single secondary select statement.
+	 * Available for collections only.  When accessing a non-initialized collection, this fetch mode will trigger loading all elements of all collections of the same role for all owners associated with the persistence context using a single secondary select.
 	 */
 	SUBSELECT
 }