[hibernate-issues] [Hibernate-JIRA] Created: (HHH-5467) API documentation for @Fetch(SUBSELECT) is ambiguous.

API documentation for @Fetch(SUBSELECT) is ambiguous. ----------------------------------------------------- Key: HHH-5467 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-5467 Project: Hibernate Core Issue Type: Bug Components: documentation Reporter: Lincoln Baxter, III Priority: Minor Current API doc states: "use a subselect query to load the additional collections" To an SQL speaker, this could imply that the collection is being fetched in the same SQL statement that is selecting the parent. SELECT ... from PARENT, (SELECT ... from CHILD) Which is semantically equivalent to a JOIN, but is just a little confusing. I think explaining in the API docs what sub-select actually does (a second select of all children from all parents via a sub-select including the original select statement) would help clarify. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira