better error handling; minor documentation update