Incomplete/non-informative javadocs for events system

Description

See also HHH-1942.

As per the documentation at http://www.hibernate.org/hib_docs/v3/api/org/hibernate/event/PreUpdateEventListener.html (as an example) and I most definately do not consider <pre><code>org.hibernate.event
Interface PreUpdateEventListener

All Superinterfaces:
Serializable

All Known Implementing Classes:
JACCPreUpdateEventListener

public interface PreUpdateEventListener extends Serializable

Called before updating the datastore

Author:
Gavin King

Method Summary
boolean onPreUpdate(PreUpdateEvent event)

Method Detail
onPreUpdate

public boolean onPreUpdate(PreUpdateEvent event)</code></pre> to be "documented" in any meaningful sense. It would be terrific if the event system javadocs as a whole were on par with the quality of the core hibernate javadocs.

Environment

None

Assignee

Diego Plentz

Reporter

Jacob L E Blain Christen

Fix versions

None

Labels

None

backPortable

None

Suitable for new contributors

None

Requires Release Note

None

Pull Request

None

backportDecision

None

Components

Priority

Minor
Configure