Doc'd event.py, although a decision is required on some aspects of this API.