Simplify docstrings
Remove unused local variable
Document the STATUS protocol in docstrings
Improve status reporting code

Rename flycheck-report-error more appropriately, and consolidate
reporting.
Document status protocol in API docs