Add a note about equals() and hashCode() on bag/idbag to the documentation -------------------------------------------------------------------------- Key: HHH-1642 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-1642 Project: Hibernate Core Issue Type: Bug Components: documentation Affects Versions: 3.1.3 Reporter: Aleksei Valikov Priority: Trivial Original Estimate: 0.25h Remaining Estimate: 0.25h bag and idbag collections don't support equals() and hashCode(). Would be nice to have that documented in the reference Here's a topic on that: http://forum.hibernate.org/viewtopic.php?p=2299735#2299735