added javadoc for listeners