allow event suspension
docs update