document error callback behaviour