doco, examples and tests for getevent(s?)