more exception docs and doctests