Improve comments related to the event shim code.