added some javadoc for the events