Provide proper documentation for org.hibernate.event.PreUpdateEventListener and org.hibernate.event.PreInsertEventListener.
1) What does the return method (boolean) of their methods mean ?
2) Who calls it and when ?
This would be nice. It's not completely obvious what the boolean return value is supposed to mean.
Couldn't find the documentation on the classes.
Despite being marked fixed, the return value is still not documented. I've filled HHH-3237.