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

[Lincoln Baxter, III (JIRA)]

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.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira