doc improvement
added a mechanism to cancel the dispatch and move on to the next
doc improvements