Interfaces PreInsertEventListener and PreUpdateEventListener are badly javadoc-documented ----------------------------------------------------------------------------------------- Key: HHH-1942 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-1942 Project: Hibernate3 Issue Type: Task Components: documentation Affects Versions: 3.1.3, 3.2.0 cr1, 3.2.0.cr2, 3.2.0.cr3 Reporter: George Gastaldi Priority: Trivial Provide proper documentation for org.hibernate.event.PreUpdateEventListener and org.hibernate.event.PreInsertEventListener. Like: 1) What does the return method (boolean) of their methods mean ? 2) Who calls it and when ? George.