More documentation for finalization feature
Make the event_finalize* functions return an error code
Remove a no-longer-true XXXX comment.