error handling evolution to support "onfail" syntax, and documentation ... which also happens to document the new onfail syntax among other things