some doc changes and some exception reproting