test recoverable exceptions
doc wip
more tests