Document conventions related to exceptions and return values in events.h.