added documentation about \!r\! blocks to event section