998 event docs and fixes

Addresses everything in issue #998.