[hibernate-issues] [Hibernate-JIRA] Closed: (HHH-5022) Small documentation improvements in chapter 6

Small documentation improvements in chapter 6 --------------------------------------------- Key: HHH-5022 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-5022 Project: Hibernate Core Issue Type: Improvement Components: documentation Affects Versions: 3.3.2 Reporter: Sorin Postelnicu Assignee: Strong Liu Priority: Minor Fix For: 3.5.0.Next In section 6.2.3, I think it would be clearer/more correct if the final phrase would be like this: "A bag does not retain its order when it is persisted to the database, but it can be optionally sorted or ordered when it is retrieved from the database." Also, at the end of section 14.3, before the paragraph with "The fetch construct cannot be used in queries called using...", it would be good if you add something like: "<strong>Limitations:</strong>", so that people can easily spot them in the documentation and be aware of them. And also the correct sentence should be "Fetch should NOT be used together with setMaxResults() or setFirstResult(), as these operations..." - this is a minor typo, but with major implications :) (I know that these are some of the frequent issues encountered by people who are just learning or have little experience with Hibernate) Also some small typos: In section 14.16: select usr.id, usr.name from User usr.name join usr.messages msg group by usr.id, usr.name having count(msg) >= 1 should be select usr.id, usr.name from User usr join usr.messages msg group by usr.id, usr.name having count(msg) >= 1 And in section 4.4: Session s = openSession(); Transaction tx = s.beginTransaction(); Session s = openSession(); should be Session s = openSession(); Transaction tx = s.beginTransaction();