readme and documentation updated with cancel event callback