Fix docs describing the arguments of formatFailure and formatError

- emphasize that the error tuple has to be returned even if it is not
  modified.
- remove highly misleading note about returning the test arg.
Merge pull request #492 from abeld/formatFailure-doc-fixes

Fix docs describing the arguments of formatFailure and formatError