document custom error handling.
Fix up documentation