Improvement to events docs per #8853

Per #8853, improvements to documentation for addListener, removeListener and newListener to reflect the fact that addListener allows any single listener to be added multiple times (which is silly, but needs to documented)