added some more JavaDoc before looking at event bubbling.