Make events documentation more clear

Fixes #2335. See also Issue #2202.