document exception
updated dox